MCP Claude Spotify
@imprvhub
An integration that allows Claude Desktop to interact with Spotify using the Model Context Protocol (MCP).
Overview
What is MCP Claude Spotify?
An integration that allows Claude Desktop to interact with Spotify using the Model Context Protocol (MCP). It enables searching, playback control, playlist management, and discovery features directly through natural language conversations with Claude.
How to use MCP Claude Spotify?
Install via Smithery (npx -y @smithery/cli install @imprvhub/mcp-claude-spotify --client claude) or manually by cloning the repository and running node build/index.js. Obtain Spotify API credentials from the Spotify Developer Dashboard, then configure Claude Desktop by editing claude_desktop_config.json with the absolute path to the server and environment variables for SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET. After configuration, restart Claude Desktop and use the auth-spotify command to authenticate; then restart Claude Desktop again to finalize tool registration.
Key features of MCP Claude Spotify
- Spotify authentication via OAuth
- Search for tracks, albums, artists, and playlists
- Playback control: play, pause, next, previous
- Full playlist management (create, update, delete, reorder, cover images)
- Get personalized recommendations from seed tracks, artists, or genres
- Access user’s top played tracks over different time periods
- View recently played tracks
Use cases of MCP Claude Spotify
- Find and play a specific track or album using voice or text commands
- Create and organize playlists, including reordering and updating cover images
- Discover new music based on your listening history or favorite artists
- Control playback on an active Spotify device without leaving Claude
- View your top tracks from the past month, year, or all time
FAQ from MCP Claude Spotify
What are the requirements to use MCP Claude Spotify?
Node.js 16 or higher, a Spotify account, Claude Desktop, and Spotify API credentials (Client ID and Client Secret).
How do I get Spotify API credentials?
Go to the Spotify Developer Dashboard, log in, create a new app, and note the Client ID and Client Secret. Set the Redirect URI to http://127.0.0.1:8888/callback.
How do I configure Claude Desktop for MCP Claude Spotify?
Edit the claude_desktop_config.json file (located at ~/Library/Application Support/Claude/ on macOS or %APPDATA%\Claude\ on Windows) to add a spotify entry under mcpServers with command: "node", args pointing to the absolute path of the server, and env containing SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET.
How do I authenticate with Spotify after installation?
In Claude, use the auth-spotify command. A browser window will open to authorize the application. After successful authentication, restart Claude Desktop to properly initialize the MCP’s tool registry and WebSocket session token cache.
Can I auto-start the MCP server with my operating system?
Yes. The README provides auto-start instructions for Windows (batch file in Startup folder), macOS (LaunchAgent plist), and Linux (systemd user service) to run the server automatically.