spotify-soundtrack-mcp

115 FastMCP Tools for Spotify & TMDB — filmography playlists, smart playlist curation, a local library cache, vibe/radio/era/time-capsule playlist generators, taste analytics, Spotify Connect hardware control, and a built-in Soundtrack Curator & Staging Studio web UI.

Installation

pip install spotify-soundtrack-mcp

Quick Start

1. Configure credentials

Create a .env file in your working directory:

# Spotify Developer App credentials (PKCE — no secret needed!)
# Get yours at https://developer.spotify.com/dashboard
SPOTIPY_CLIENT_ID=your_spotify_client_id_here
SPOTIPY_REDIRECT_URI=http://127.0.0.1:8888/callback

# TMDB (optional, enables cinema/filmography features)
# Get from https://www.themoviedb.org/settings/api
TMDB_API_KEY=your_tmdb_api_key_here
# OR: TMDB_READ_ACCESS_TOKEN=your_tmdb_read_access_token_here

Important: In your Spotify Developer Dashboard, add http://127.0.0.1:8888/callback as a Redirect URI.

2. Authenticate

spotify-mcp-auth

This opens your browser for Spotify login and saves the token locally.

3. Run

For Claude Desktop / Cursor (stdio transport):

spotify-mcp
# With a specific toolset (recommended for token efficiency):
spotify-mcp --toolsets=core

For web/remote SSE transport:

spotify-soundtrack-mcp
# Custom host/port via env:
HOST=0.0.0.0 PORT=8080 spotify-soundtrack-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "spotify": {
      "command": "spotify-mcp",
      "args": ["--toolsets=core"],
      "env": {
        "SPOTIPY_CLIENT_ID": "your_client_id",
        "TMDB_API_KEY": "your_tmdb_key"
      }
    }
  }
}

Toolsets

spotify-mcp --toolsets=core,playback
spotify-mcp --toolsets=all

Environment Variables

Links

• GitHub Repository
• Web App Package (spotify-mcp-web)
• Report Issues