Skip to content
MCP server

Spotify Soundtrack MCP

Spotify and TMDB tools for movie soundtrack playlists, curation and taste stats

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
1.1.0
Listing updated
today

Similar MCP servers

About Spotify Soundtrack MCP

Spotify Soundtrack MCP is a free MCP server for events and entertainment. It runs locally on your machine and is started by your AI client.

The project is built around Indian film music. It can build playlists from an actor's filmography and match soundtracks for Kannada, Telugu, Tamil, Malayalam and Hindi movies, including songs credited as From "Movie Name". It works with any music on Spotify, but the README says Indian cinema is where it is strongest. Movie, cast and crew lookups come from TMDB.

The server registers 115 tools plus 20 agent skills, loaded in toolsets (core by default, or playback, playlists, search, taste, library, browse, all) through SPOTIFY_TOOLSETS. Sign-in uses Spotify's PKCE flow, so only a Client ID is needed, not a secret. A local library cache from spotify_sync_library powers vibe, era, time-capsule and radio playlist generators, each of which previews first and only creates a playlist with create=True.

The README documents Spotify's 2026 Development Mode limits: related artists, recommendations, audio features and artist top tracks are gone, so the tools substitute collaborator networks, genre search and estimated vibes. It also ships a local web app, the Soundtrack Curator & Staging Studio.

Install

Run in a terminal

claude mcp add spotify-soundtrack-mcp --env SPOTIPY_CLIENT_ID='<SPOTIPY_CLIENT_ID>' --env TMDB_API_KEY='<TMDB_API_KEY>' --env TMDB_READ_ACCESS_TOKEN='<TMDB_READ_ACCESS_TOKEN>' -- uvx spotify-soundtrack-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "spotify-soundtrack-mcp": {
      "command": "uvx",
      "args": [
        "spotify-soundtrack-mcp"
      ],
      "env": {
        "SPOTIPY_CLIENT_ID": "<SPOTIPY_CLIENT_ID>",
        "TMDB_API_KEY": "<TMDB_API_KEY>",
        "TMDB_READ_ACCESS_TOKEN": "<TMDB_READ_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "spotify-soundtrack-mcp": {
      "command": "uvx",
      "args": [
        "spotify-soundtrack-mcp"
      ],
      "env": {
        "SPOTIPY_CLIENT_ID": "<SPOTIPY_CLIENT_ID>",
        "TMDB_API_KEY": "<TMDB_API_KEY>",
        "TMDB_READ_ACCESS_TOKEN": "<TMDB_READ_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "spotify-soundtrack-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "spotify-soundtrack-mcp"
      ],
      "env": {
        "SPOTIPY_CLIENT_ID": "<SPOTIPY_CLIENT_ID>",
        "TMDB_API_KEY": "<TMDB_API_KEY>",
        "TMDB_READ_ACCESS_TOKEN": "<TMDB_READ_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "spotify-soundtrack-mcp": {
      "command": "uvx",
      "args": [
        "spotify-soundtrack-mcp"
      ],
      "env": {
        "SPOTIPY_CLIENT_ID": "<SPOTIPY_CLIENT_ID>",
        "TMDB_API_KEY": "<TMDB_API_KEY>",
        "TMDB_READ_ACCESS_TOKEN": "<TMDB_READ_ACCESS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "spotify-soundtrack-mcp": {
      "command": "uvx",
      "args": [
        "spotify-soundtrack-mcp"
      ],
      "env": {
        "SPOTIPY_CLIENT_ID": "<SPOTIPY_CLIENT_ID>",
        "TMDB_API_KEY": "<TMDB_API_KEY>",
        "TMDB_READ_ACCESS_TOKEN": "<TMDB_READ_ACCESS_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SPOTIPY_CLIENT_IDClient ID of your Spotify app (https://developer.spotify.com/dashboard). Sign-in uses PKCE, so no client secret is needed.Required
  • SPOTIPY_REDIRECT_URIRedirect URI registered for your Spotify app.
  • TMDB_API_KEYTMDB v3 API key for movie, cast and filmography lookups. Set this or TMDB_READ_ACCESS_TOKEN.
  • TMDB_READ_ACCESS_TOKENTMDB v4 Read Access Token, an alternative to TMDB_API_KEY.
  • SPOTIFY_TOOLSETSComma-separated toolsets to load: core, playback, playlists, search, taste, library, browse or all.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

spotify_sync_library
Downloads liked songs and owned playlists into a local cache.
spotify_query_library
Answers questions about your music from the local cache.
spotify_library_stats
Returns statistics on the cached library.
spotify_vibe_playlist
Builds a playlist for a mood or energy target from songs you already like.
spotify_era_playlist
Builds a playlist for an era.
spotify_time_capsule_playlist
Builds a playlist from songs saved in a given year.
spotify_radio_playlist
Mixes an artist's songs with those of collaborators.
get_artist_network
Lists artists who share the most songs with an artist.
spotify_taste_profile
Reports artist variety and eras in your listening.
spotify_discover_deep_cuts
Finds album tracks outside an artist's top search results.

What it does

Filmography playlists
Builds Spotify playlists from an actor's or film's TMDB data.
Toolset loading
Choose core, playback, playlists, search, taste, library or browse to limit the tool count.
Local library cache
Syncs liked songs and owned playlists to a JSON file for offline queries.
Preview-first generators
Vibe, era, radio and time-capsule playlists are only created when told to.
Workarounds for removed APIs
Replaces missing recommendations and audio features with collaborator and genre logic.
PKCE sign-in
Needs only a Spotify Client ID, with no client secret.

Good for

  • Make a playlist from every song in an actor's films
  • Match a Tamil or Telugu movie to its soundtrack on Spotify
  • Summarise your listening taste and eras
  • Build a mood playlist from songs you already saved
  • Control playback on a Spotify Connect device

Pricing

Free

Free to run; needs your own Spotify and TMDB credentials

Spotify Soundtrack MCP FAQ

What accounts or keys are needed?

A Spotify app Client ID and a TMDB API key or Read Access Token.

Which clients can use it?

Any MCP client over stdio, such as Claude Desktop or Cursor.

Is audio-feature data available?

No. Spotify removed it for Development Mode apps, so tools return an unavailable message or estimate vibes from genres.

How do I install it?

pip install spotify-soundtrack-mcp, then run spotify-mcp-auth to connect Spotify.

Is Spotify Soundtrack MCP free?

Yes. Spotify Soundtrack MCP is free to use.

How do I add Spotify Soundtrack MCP to Claude Code?

Run this command in your terminal: claude mcp add spotify-soundtrack-mcp --env SPOTIPY_CLIENT_ID='<SPOTIPY_CLIENT_ID>' --env TMDB_API_KEY='<TMDB_API_KEY>' --env TMDB_READ_ACCESS_TOKEN='<TMDB_READ_ACCESS_TOKEN>' -- uvx spotify-soundtrack-mcp

What are the best alternatives to Spotify Soundtrack MCP?

The closest alternatives to Spotify Soundtrack MCP are Dostuff, Skiddle, Madrid Events, Nyc Parks and Edmtrain.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers