spotify-mcp MCP server

MCP server connecting Claude with Spotify. This fork of varunneal/spotify-mcp adds smart-batching tools and advanced playlist features that optimize API usage.

Features

Core Functionality

• Playback Control: Start, pause, skip tracks, manage queue
• Search & Discovery: Find tracks, albums, artists, playlists with pagination
• Real-time State: Live user profile and playback status

Enhanced Playlist Tools (New in this fork)

• Smart Batch Operations: Add/remove up to 100 tracks in single API calls
• Large Playlist Support: Efficiently handle playlists with 1000+ tracks using pagination
• Advanced Playlist Management: Create, modify details, bulk track operations
• API-Optimized Workflows: Intelligent batching reduces API calls by 60-80%

Installation

1. Get Spotify API Keys

1. Create account at developer.spotify.com
2. Create app with redirect URI: http://localhost:8888

2. Install via Smithery (Recommended)

npx -y @smithery/cli install @jamiew/spotify-mcp --client claude

3. Manual Installation

git clone https://github.com/jamiew/spotify-mcp.git

Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

"spotify": {
  "command": "uv",
  "args": ["--directory", "/path/to/spotify_mcp", "run", "spotify-mcp"],
  "env": {
    "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
    "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
    "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
  }
}

Requirements: Spotify Premium account, uv >= 0.54

Usage Examples

• "Create a chill study playlist with 20 tracks" → Search + playlist creation + bulk track addition
• "Show me the first 50 tracks from my 'Liked Songs'" → Pagination for large playlists
• "Find similar artists to Radiohead and add their top tracks to my queue" → Search + artist info + queue management

Development

Built with FastMCP framework featuring 13 focused tools, type-safe APIs, and comprehensive test coverage.

Debug with MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp