Spotify Soundtrack MCP
Spotify and TMDB tools for movie soundtrack playlists, curation and taste stats
- 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-mcpAdd 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.RequiredSPOTIPY_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.
