MCP Claude Spotify
A Spotify MCP server for Claude Desktop: music search, playback and playlist control and listening history.
- 53 ★ on the repository
- Last commit
- MPL-2.0
Extended access
Why this level
- The server controls playback and edits playlists on your Spotify account.
- Access tokens are stored in a file on your computer.
Install
- Works in
Manual install
npx -y @smithery/cli@latest mcp add imprvhub/mcp-claude-spotify --client claudeAutomatic install through Smithery, the manual way is described in the README.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server controls playback and edits playlists on your Spotify account.
- Access tokens are stored in a file on your computer.
This is third-party code. Review the repository files before installing.
What it does
MCP Claude Spotify connects Spotify to Claude Desktop through MCP. After authorization the assistant searches tracks, albums, artists and playlists, controls playback (play, pause, next, previous) and fully manages playlists: creates, edits, deletes, reorders tracks and changes covers. It also shows your top played tracks over different periods and recent plays. The `get-recommendations` tool was removed in version 0.6.0 because Spotify closed that endpoint on 27 November 2024. Use `search-spotify` and `get-top-tracks` instead. Tokens are saved in `~/.spotify-mcp/tokens.json` and sign-in uses OAuth with the Client ID and Client Secret of your Spotify app.
Who it is for. Spotify and Claude Desktop users who want to run music and playlists through conversation with the assistant.
Good fit when
- The assistant builds a playlist from found tracks for a described mood.
- While working you ask for the next track or a pause.
- You check top tracks for the month and recently played.
- You tidy a playlist: reorder, remove extras, change the cover.
Not a fit when
- You need Spotify recommendations because the endpoint is closed.
- You have no Spotify account or developer app.
- The client is not Claude Desktop.
Example request
Find my most played tracks this month and build a new "Morning" playlist from them without duplicates.MCP
- Transport
- stdio
- Authentication
- OAuth
Environment variables
SPOTIFY_CLIENT_IDrequired- Spotify app Client ID.
SPOTIFY_CLIENT_SECRETrequired, secret- Spotify app Client Secret.
SPOTIFY_AUTO_AUTH- Set to true to open the Spotify login on start when no tokens are stored.
Limitations
You need Node.js 20 or newer, a Spotify account, Claude Desktop and an app in the Spotify Developer Dashboard with a Client ID, Client Secret and the callback `http://127.0.0.1:8888/callback`. Recommendations, related artists, audio features and 30 second previews are unavailable because Spotify closed those endpoints in November 2024. The server controls playback and edits playlists on your account, so grant the assistant only the rights it needs.
How to disable. Remove the entry from `claude_desktop_config.json`, delete `~/.spotify-mcp/tokens.json` and revoke the app access in Spotify settings.
FAQ
How do I install the server?
Through Smithery with `npx -y @smithery/cli@latest mcp add imprvhub/mcp-claude-spotify --client claude` or manually: clone the repository, run `npm install` and `npm run build` if needed.
How do I get Spotify credentials?
Create an app in the Spotify Developer Dashboard, set the callback `http://127.0.0.1:8888/callback` and copy the Client ID and Client Secret.
How do I sign in to Spotify?
Ask Claude to authenticate and the `auth-spotify` tool runs. Or start the server once with `SPOTIFY_AUTO_AUTH=true`.
Why are there no recommendations?
`get-recommendations` was removed in version 0.6.0 because Spotify closed the endpoint. Use `search-spotify` and `get-top-tracks`.
Where are tokens stored?
In `~/.spotify-mcp/tokens.json` on your computer.
Discussion
No questions or reviews yet.
Related
MCP serversA Spotify MCP server: the agent searches music, controls playback, queue and volume, and builds and edits playlists and the library
A Python library and MCP server that give an agent public Spotify data, lyrics and transcripts with no API key
applemusic-mcp: Apple Music for Claude and Cursor
applemusic-mcp
An MCP server for Apple Music playlists, library, catalog, playback and the queue, with an access level that you set
MCP Music Studio: music in chat with an agent
mcp-music-studio
An MCP server where an agent writes ABC sheet music or a Strudel live beat and the player with an editor opens in chat
An MCP server for a local Rust-based Yandex Music player and sync daemon on Linux: playback control, taste profile, mood picks
flstudio-mcp: control FL Studio with Claude
flstudio-mcp
An MCP server with 72 tools for FL Studio 2025: mix diagnosis, plugins, piano roll, routing and MIDI export for Claude
README in short
The README lists features, requirements, getting Spotify credentials and two ways to run. A separate note reports the removal of the recommendations tool.