get_album
Get Album
Retrieve detailed information about an album including its metadata, track listing, and artwork. Also supports browsing new album releases.
get_album
Retrieve detailed information about an album including its metadata, track listing, and artwork. Also supports browsing new album releases.
get_track
Retrieve detailed information about one or more tracks including metadata, audio features (danceability, energy, tempo, etc.), and album info. Supports fetching up to 50 tracks at once.
search_catalog
Search across Spotify's catalog for tracks, artists, albums, and playlists using keyword queries. Results can be filtered by content type and market. Useful for finding specific music content or discovering new items matching a search term.
control_playback
Control Spotify playback on any connected device. Play, pause, skip, seek, adjust volume, toggle shuffle/repeat, transfer playback between devices, and add items to the queue. Also retrieve current playback state, available devices, and the user's queue.
get_recently_played
Retrieve the user's recently played tracks with timestamps and context information (e.g., which playlist or album the track was played from). Returns up to 50 recent tracks.
get_user_profile
Retrieve a Spotify user profile. Fetch the current authenticated user's full profile (including email, subscription, and country if scoped) or any user's public profile by their user ID.
get_artist
Retrieve detailed information about an artist including their profile, top tracks, albums, and related artists. Combine multiple aspects of artist data in a single call by selecting what to include.
manage_playlist
Create, update, and manage Spotify playlists. Supports creating new playlists, updating playlist details (name, description, visibility), adding or removing tracks, reordering items, and retrieving playlist contents. Also allows listing all of the current user's playlists.
manage_following
Manage the user's followed artists, users, and playlists. Follow or unfollow artists/users, check follow status, list followed artists, and follow/unfollow playlists.
get_top_items
Retrieve the current user's most listened-to artists or tracks based on calculated affinity. Supports three time ranges: short-term (last 4 weeks), medium-term (last 6 months), and long-term (several years of data).
manage_library
Manage the user's Spotify library ("Your Music"). Save or remove tracks and albums, check if specific items are already saved, and list saved items with pagination.
Search and browse Spotify's music catalog for tracks, artists, albums, playlists, podcasts, and episodes. Create, edit, and manage playlists including adding, removing, and reordering items. Control playback across devices: play, pause, skip, seek, set volume, toggle shuffle and repeat, and transfer playback. Save and remove items from the user's library. Retrieve user profiles, top artists and tracks, and recently played history. Follow and unfollow artists, users, and playlists. Access audio features and analysis data for tracks. Upload custom playlist cover images.
Common questions about connecting Spotify to AI agents with Metorial.