imprvhub/mcp-claude-spotify

An integration that allows Claude Desktop to interact with Spotify using the Model Context Protocol (MCP).
> **Removed in 0.6.0 — get-recommendations.** Spotify deprecated /v1/recommendations
> on 27 November 2024, along with related-artists, audio-features, audio-analysis,
> featured-playlists and 30-second preview URLs. Apps created after that date get
> 403 Forbidden, and apps still in development mode lost access too, so the tool could
> not work for essentially anyone. Use search-spotify and get-top-tracks instead.
> See Spotify's announcement.
Features
- Spotify authentication
- Search for tracks, albums, artists, and playlists
- Playback control (play, pause, next, previous)
- Full playlist management (create, update, delete, reorder tracks, manage cover images)
- Read your top tracks and listening history
- Access user's top played tracks over different time periods
- View recently played tracks
Demo
Requirements
- Node.js 20 or higher
- Spotify account
- Claude Desktop
- Spotify API credentials (Client ID and Client Secret)
Installation
Installing via Smithery
To install MCP Claude Spotify for Claude Desktop automatically via Smithery:
Installing Manually
1. Clone or download this repository:
2. Install dependencies:
3. Build the project (if you want to modify the source code):
The repository already includes pre-built files in the build directory, so you can skip step 3 if you don't plan to modify the source code.
Setting up Spotify Credentials
To use this MCP, you need to obtain Spotify API credentials:
1. Go to Spotify Developer Dashboard
2. Log in with your Spotify account
3. Click "Create App"
4. Fill in your app information:
- App name: "MCP Claude Spotify" (or whatever you prefer)
- App description: "Spotify integration for Claude Desktop"
- Website: You can leave this blank or put any URL
- Redirect URI: **Important** - Add http://127.0.0.1:8888/callback
5. Accept the terms and conditions and click "Create"
6. In your app dashboard, you'll see the "Client ID"
7. Click "Show Client Secret" to reveal your "Client Secret"
Save these credentials as you'll need them for configuration.
Running the MCP Server
There are two ways to run the MCP server:
Option 1: Authorize once from a terminal (first-time setup)
Claude Desktop starts its own copy of the server, so a server left running in a terminal is
not the one Claude talks to. What a terminal run is useful for is authorizing once: with
SPOTIFY_AUTO_AUTH=true and no stored tokens, the server opens the Spotify login in your
browser as soon as it starts.
Approve the request in the browser. Once the terminal prints "Authorization complete",
stop the process with Ctrl+C. The token is saved to ~/.spotify-mcp/tokens.json, and the
copy Claude Desktop starts will pick it up.
You can skip this step entirely and ask Claude to "authenticate with Spotify" instead, which
runs the auth-spotify tool and opens the same login page.
Option 2: Auto-starting with Claude Desktop (recommended for regular use)
The Claude Desktop can automatically start the MCP server when needed. To set this up:
Configuration
The Claude Desktop configuration file is located at:
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
Edit this file to add the Spotify MCP configuration. If the file doesn't exist, create it:
**Important**: Replace:
- ABSOLUTE_PATH_TO_DIRECTORY with the **complete absolute path** where you installed the MCP
- macOS/Linux example: /Users/username/mcp-claude-spotify
- Windows example: C:\\Users\\username\\mcp-claude-spotify
- your_client_id_here with the Client ID you obtained from Spotify
- your_client_secret_here with the Client Secret you obtained from Spotify
If you already have other MCPs configured, simply add the "spotify" section inside the "mcpServers" object.
Setting up auto-start scripts (Optional)
For a more reliable experience, you can set up auto-start scripts:
Windows auto-start instructions
1. Create a file named start-spotify-mcp.bat in the project directory with the following content:
2. Create a shortcut to this BAT file