Skip to main content
MCP server CX Codex

Spotify Soundtrack MCP — Claude Code MCP server: features and setup

The Spotify Soundtrack MCP MCP server for Claude Code connects Spotify with TMDB to build movie-based playlists. It also curates playlists and reports listening-taste stats.

MIT ★ 5 updated 2026-11-09

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env SPOTIPY_CLIENT_ID=<SPOTIPY_CLIENT_ID> --env SPOTIPY_REDIRECT_URI=<SPOTIPY_REDIRECT_URI> --env TMDB_API_KEY=<TMDB_API_KEY> --env TMDB_READ_ACCESS_TOKEN=<TMDB_READ_ACCESS_TOKEN> --env SPOTIFY_TOOLSETS=<SPOTIFY_TOOLSETS> --transport stdio spotify-soundtrack-mcp -- uvx spotify-soundtrack-mcp
Open on GitHub

What Spotify Soundtrack MCP does

The server looks up films, cast, and crew in TMDB, then uses filmographies to build Spotify playlists. It can also curate playlists, analyse listening habits, and control playback through Spotify Connect.

Spotify sign-in requires SPOTIPY_CLIENT_ID and uses browser-based PKCE, with no client secret. For TMDB, provide either TMDB_API_KEY or TMDB_READ_ACCESS_TOKEN. Some Spotify features are unavailable in Development Mode: audio-feature data is blocked, for example, and other users’ profiles cannot be accessed. Playlist generators show a preview first; they create a playlist only when called with create=True.

What it helps with

  • build a playlist from an actor’s filmography
  • find a movie soundtrack through TMDB
  • make a mood playlist from liked songs
  • inspect listening-taste statistics

Example prompts for the agent

  • Build a Spotify playlist from this Indian film actor’s filmography.
  • Find the soundtrack for this movie through TMDB and create a playlist.
  • Show statistics for my Spotify music library.

How to install Spotify Soundtrack MCP

Platform CLI

claude mcp add --env SPOTIPY_CLIENT_ID=<SPOTIPY_CLIENT_ID> --env SPOTIPY_REDIRECT_URI=<SPOTIPY_REDIRECT_URI> --env TMDB_API_KEY=<TMDB_API_KEY> --env TMDB_READ_ACCESS_TOKEN=<TMDB_READ_ACCESS_TOKEN> --env SPOTIFY_TOOLSETS=<SPOTIFY_TOOLSETS> --transport stdio spotify-soundtrack-mcp -- uvx spotify-soundtrack-mcp

Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from spotify-soundtrack-mcp <command>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Spotify Soundtrack MCP

How do I install Spotify Soundtrack MCP in Claude Code?

Run `claude mcp add spotify-soundtrack-mcp -e SPOTIPY_CLIENT_ID=<SPOTIPY_CLIENT_ID> -e TMDB_API_KEY=<TMDB_API_KEY> -e TMDB_READ_ACCESS_TOKEN=<TMDB_READ_ACCESS_TOKEN> -- uvx spotify-soundtrack-mcp`. Then sign in to Spotify in the browser.

What does Spotify Soundtrack MCP do?

It connects Spotify and TMDB, finds films and their cast or crew, creates playlists from filmographies, curates music, and analyses listening tastes.

What does Spotify Soundtrack MCP need to run?

Spotify sign-in needs SPOTIPY_CLIENT_ID; TMDB needs either TMDB_API_KEY or TMDB_READ_ACCESS_TOKEN. Spotify authentication uses browser-based PKCE and does not require a client secret.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open