# Spotify Soundtrack MCP

> Spotify Soundtrack MCP is a free MCP server for events and entertainment. Spotify and TMDB tools for movie soundtrack playlists, curation and taste stats. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted, Web
- **Repository:** https://github.com/chiru144/spotify-mcp-web-and-mcp-server
- **MCP Registry name:** io.github.Chiru144/spotify-soundtrack-mcp
- **Categories:** [events and entertainment](https://ai-powered.com/categories/events-and-entertainment)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Dostuff](https://ai-powered.com/mcp/dostuff): Dostuff is a freemium MCP server for events and entertainment.
- [Skiddle](https://ai-powered.com/mcp/skiddle): Skiddle is a freemium MCP server for events and entertainment.
- [Madrid Events](https://ai-powered.com/mcp/madrid-events): Madrid Events is a freemium MCP server for events and entertainment.
- [Nyc Parks](https://ai-powered.com/mcp/nyc-parks): Nyc Parks is a freemium MCP server for events and entertainment.
- [Edmtrain](https://ai-powered.com/mcp/edmtrain): Edmtrain is a freemium MCP server for events and entertainment.
- [Countdowns Online MCP](https://ai-powered.com/mcp/countdowns-online-mcp-2): Countdowns Online MCP is an open-source MCP server for events and entertainment.
- [Luma](https://ai-powered.com/mcp/luma): Luma is a freemium MCP server for events and entertainment.
- [Eventbrite](https://ai-powered.com/mcp/eventbrite): Eventbrite is a freemium MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/spotify-soundtrack-mcp
