Spotify

Control your Spotify music playback through conversations using the Spotify API.

View on GitHub →

Spotify MCP Server

A Model Context Protocol (MCP) server that connects Claude to Spotify, allowing you to control your music directly from conversations.

Features

  • Playback Control: Play, pause, skip tracks, and control volume
  • Music Discovery: Search for tracks, albums, artists, and playlists
  • Enhanced Search: Combines Spotify data with external metadata from Last.fm and MusicBrainz
  • Similar Artists: Find similar artists using Last.fm's collaborative filtering
  • Rich Metadata: Genre tags, artist biographies, detailed music relationships, and community data
  • Queue Management: Add tracks to your queue and view what's coming up
  • Playlist Management: Create, modify, and manage your playlists
  • Music Information: Get detailed info about any track, album, or artist
  • Smart Authentication: Automatic token management - authenticate once, use forever

Quick Start

1. Get Spotify API Credentials

  1. Go to Spotify Developer Dashboard
  2. Create a new app
  3. Set the redirect URI to: http://127.0.0.1:8080/callback
  4. Note your Client ID and Client Secret

1.5. Optional: Get Last.fm API Key (for Enhanced Features)

For enhanced music discovery features:

  1. Go to Last.fm API account creation
  2. Create an API account
  3. Note your API Key

Note: Enhanced features will work without Last.fm API key, but with limited external metadata.

2. Install the Server

git clone https://github.com/varunneal/spotify-mcp.git
cd spotify-mcp

3. Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "spotify": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/spotify-mcp",
        "run",
        "spotify-mcp"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret_here",
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback",
        "LASTFM_API_KEY": "your_lastfm_api_key_here"
      }
    }
  }
}

4. First Time Setup

  1. Restart Claude Desktop
  2. Start a conversation and say: "Check my Spotify authentication status"
  3. Follow the prompts to authenticate (one-time setup)
  4. Start using Spotify commands!

Example Conversations

You: "Play some jazz music"
Claude: [Searches for jazz, starts playing]

You: "What's currently playing?"
Claude: [Shows current track info]

You: "Find me artists similar to Radiohead"
Claude: [Uses Last.fm data to find similar artists with match scores]

You: "Do an enhanced search for 'Bohemian Rhapsody'"
Claude: [Combines Spotify data with Last.fm genre tags, MusicBrainz metadata, and additional context]

You: "Add this to my favorites playlist"
Claude: [Adds current track to specified playlist]

You: "Skip to the next song"
Claude: [Skips track]

Requirements

  • Spotify Premium (required for playback control)
  • Python 3.12+
  • uv package manager
  • Claude Desktop

Development & Testing

Test your setup before using with Claude:

# Test authentication and basic functionality
python test_auth.py

# If you need to authenticate, run with the code:
python test_auth.py YOUR_AUTH_CODE_HERE

Debugging

Common Issues

"No active device": Open Spotify on any device (phone, computer, etc.)

"Authentication failed": Use the Authentication tool to get a new auth URL

"Permission denied": Make sure you have Spotify Premium

Logs

  • macOS: ~/Library/Logs/Claude/
  • Windows: Check Claude Desktop logs
  • Debug mode: Use MCP Inspector: 
    npx @modelcontextprotocol/inspector uv --directory /path/to/spotify-mcp run spotify-mcp

Available Commands

The server automatically handles all Spotify operations through natural conversation. You can:

  • Control playback (play, pause, skip, volume)
  • Search for any music content
  • Enhanced search with external metadata (Last.fm + MusicBrainz)
  • Find similar artists using collaborative filtering
  • Manage your queue
  • Work with playlists
  • Get information about tracks/artists/albums
  • Check what's currently playing

New Enhanced Features

  • Enhanced Search: Combines Spotify results with genre tags, artist biographies, and detailed music relationships
  • Similar Artists: Find artists similar to your favorites using Last.fm's collaborative filtering data
  • Rich Metadata: Additional context including community tags, listening statistics, and music database information

Privacy & Security

  • Tokens are cached locally and refreshed automatically
  • No data is stored beyond what's needed for authentication
  • Standard OAuth2 flow - same as any Spotify app
  • Revoke access anytime in your Spotify account settings

Contributing

PRs welcome! This project is actively maintained.

License

MIT License - see LICENSE file for details

Need help? Open an issue on GitHub or check the troubleshooting section above.

Related Servers