playbooks

home / mcp / spotify mcp server

Spotify MCP Server

MCP to connect Claude with Spotify. This fork adds new features, including new batch-tools like "find recommendations" that save on API calls

Installation
Add the following to your MCP client configuration file.

Configuration

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

This MCP server connects Claude with Spotify, enabling playback control, search, discovery, and advanced playlist management with optimized API usage. It brings smart batching and large playlist handling to streamline your Spotify automation workflows from Claude.

How to use

You interact with the Spotify MCP Server through an MCP client to control playback, search for tracks, and manage playlists. You can create playlists, add or remove many tracks in bulk, and queue tracks based on your prompts. The system supports pagination for large results and batch operations to minimize API calls. Use practical prompts like: “Create a chill study playlist with 20 tracks,” “Show the first 50 tracks from my Liked Songs,” or “Find similar artists to Radiohead and add their top tracks to my queue.” The server handles these requests by combining search, playlist management, and queue operations into efficient actions.

Key capabilities

Playback Control: Start, pause, skip tracks, and manage your playback queue.

Search & Discovery: Find tracks, albums, artists, and playlists with pagination to handle large results.

Real-time State: Access live user profile and current playback status to stay in sync with your listening session.

Available tools

playback_control

Start, pause, skip tracks and manage the playback queue to control listening sessions.

search_discovery

Search tracks, albums, artists, and playlists with pagination to handle large catalogs.

real_time_state

Fetch live user profile and current playback details to stay in sync.

smart_batch_operations

Add or remove up to 100 tracks in single API calls for efficient playlist updates.

large_playlist_support

Handle playlists with 1000+ tracks efficiently using pagination.

advanced_playlist_management

Create playlists, modify details, and perform bulk track operations.

api_optimized_workflows

Intelligent batching to reduce API calls by 60-80% for smoother automation.