spotify-mcp

An MCP (Model Context Protocol) server for Spotify. Control playback, search for music, manage playlists, and get personalized recommendations -- all through any MCP-compatible client like Claude.

| Tool | Description | |------|-------------| | auth-spotify | Authenticate with Spotify via OAuth | | search-spotify | Search for tracks, albums, artists, or playlists | | get-current-playback | Get the current playback state (track, device, progress) | | play-track | Play a specific track on an active device | | pause-playback | Pause playback | | next-track | Skip to the next track | | previous-track | Skip to the previous track | | get-user-playlists | List the user's playlists | | create-playlist | Create a new playlist | | add-tracks-to-playlist | Add tracks to a playlist | | get-playlist-tracks | Get the tracks in a playlist | | rename-playlist | Rename a playlist (and optionally update description/visibility) | | unfollow-playlist | Unfollow (or delete) a playlist | | get-recommendations | Get track recommendations based on seed tracks, artists, or genres | | get-top-tracks | Get the user's top played tracks over a time range |

| Variable | Required | Description | |----------|----------|-------------| | SPOTIFY_CLIENT_ID | Yes | Spotify app client ID | | SPOTIFY_CLIENT_SECRET | Yes | Spotify app client secret | | SPOTIFY_REDIRECT_URI | No | OAuth redirect URI (defaults to http://127.0.0.1:8888/callback) |

Create a Spotify app at developer.spotify.com and add your redirect URI to the app's settings.

npm ci

node build/index.js

mcp-proxy --port 8002 -- node build/index.js

On first use, call the auth-spotify tool. It will open a browser window for Spotify OA