Spotify MCP: Documentation
Updated:
Connection
Installed from source: git clone the repo, npm install, npm run build. In spotify-config.json set the Client ID, Client Secret and Redirect URI from the Spotify Developer Dashboard, then run npm run auth, which opens a browser authorization link — tokens are saved locally and refreshed automatically by the server via the refresh token.
Capabilities
30+ tools: playback (play, pause, resume, skip tracks, volume), search (searchSpotify — tracks, albums, artists, playlists), queue (getNowPlaying, getQueue, addToQueue), playlists (createPlaylist, getMyPlaylists, getPlaylistTracks, updatePlaylist, addTracksToPlaylist, removeTracksFromPlaylist, reorderPlaylistItems), albums (getAlbums, getAlbumTracks, save/remove), library (getUsersSavedTracks, getRecentlyPlayed, removeUsersSavedTracks), devices (getAvailableDevices).
Agent flow
"Play something similar to the current track", "add the next three tracks to the queue", "create a "Focus" playlist from my recently saved tracks".
Note
A community project (by marcelmarais, 400 GitHub stars), not an official Spotify product. Requires an active Spotify Premium device to control playback — some tools don't work on a free account.