LearnHouse
Build, edit and run courses, learning paths and communities in your LearnHouse academy.
Spotify + TMDB tools: movie soundtrack playlists, playlist curation, taste stats and playback.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 9/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 21/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Spotify Soundtrack MCP. Follow https://mcp.popnx.com/i/chiru144-spotify-soundtrack-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Spotify Soundtrack MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "spotify-soundtrack": { "command": "uvx", "args": [ "spotify-soundtrack-mcp", "--transport", "stdio" ], "env": { "SPOTIPY_CLIENT_ID": "your-value", "TMDB_API_KEY": "your-value", "TMDB_READ_ACCESS_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Spotify Soundtrack MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
SettingsDeveloperEdit Config
{
"mcpServers": {
"spotify-soundtrack": {
"command": "uvx",
"args": [
"spotify-soundtrack-mcp",
"--transport",
"stdio"
],
"env": {
"SPOTIPY_CLIENT_ID": "your-value",
"TMDB_API_KEY": "your-value",
"TMDB_READ_ACCESS_TOKEN": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Spotify Soundtrack MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Spotify Soundtrack MCP or shows a Spotify Soundtrack MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SPOTIPY_REDIRECT_URI Redirect URI registered for your Spotify app. · default http://127.0.0.1:8888/callbackSPOTIFY_TOOLSETS Comma-separated toolsets to load: core, playback, playlists, search, taste, library, browse or all. · default coreDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Spotify Soundtrack MCP yet
Spotify Soundtrack MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Spotify Soundtrack MCP
B · Others in Games, sports, food & learning that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a Spotify Soundtrack MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SPOTIPY_CLIENT_ID) · Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Spotify Soundtrack MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user spotify-soundtrack --env SPOTIPY_CLIENT_ID=your-value --env TMDB_API_KEY=your-value --env TMDB_READ_ACCESS_TOKEN=your-value -- uvx spotify-soundtrack-mcp --transport stdio 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Spotify Soundtrack MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
SPOTIPY_CLIENT_ID Client ID of your Spotify app (https://developer.spotify.com/dashboard). Sign-in uses PKCE, so no client secret is needed.Descriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user spotify-soundtrack --env SPOTIPY_CLIENT_ID=your-value --env TMDB_API_KEY=your-value --env TMDB_READ_ACCESS_TOKEN=your-value -- uvx spotify-soundtrack-mcp --transport stdioReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Spotify Soundtrack MCP listed as connected
Use Spotify Soundtrack MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Spotify Soundtrack MCP or shows a Spotify Soundtrack MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SPOTIPY_REDIRECT_URI Redirect URI registered for your Spotify app. · default http://127.0.0.1:8888/callbackSPOTIFY_TOOLSETS Comma-separated toolsets to load: core, playback, playlists, search, taste, library, browse or all. · default coreDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Spotify Soundtrack MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SPOTIPY_CLIENT_ID) · Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Spotify Soundtrack MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "spotify-soundtrack": { "command": "uvx", "args": [ "spotify-soundtrack-mcp", "--transport", "stdio" ], "env": { "SPOTIPY_CLIENT_ID": "your-value", "TMDB_API_KEY": "your-value", "TMDB_READ_ACCESS_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Spotify Soundtrack MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
SPOTIPY_CLIENT_ID Client ID of your Spotify app (https://developer.spotify.com/dashboard). Sign-in uses PKCE, so no client secret is needed.Descriptions are as written by the maker.
In the Spotify Soundtrack MCP settings, TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Spotify Soundtrack MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Spotify Soundtrack MCP or shows a Spotify Soundtrack MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SPOTIPY_REDIRECT_URI Redirect URI registered for your Spotify app. · default http://127.0.0.1:8888/callbackSPOTIFY_TOOLSETS Comma-separated toolsets to load: core, playback, playlists, search, taste, library, browse or all. · default coreDescriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Spotify Soundtrack MCP key (create it on the maker’s site) · 1 setting(s) to fill in (SPOTIPY_CLIENT_ID) · Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Spotify Soundtrack MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "spotify-soundtrack": { "type": "stdio", "command": "uvx", "args": [ "spotify-soundtrack-mcp", "--transport", "stdio" ], "env": { "SPOTIPY_CLIENT_ID": "your-value", "TMDB_API_KEY": "your-value", "TMDB_READ_ACCESS_TOKEN": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Spotify Soundtrack MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
SPOTIPY_CLIENT_ID Client ID of your Spotify app (https://developer.spotify.com/dashboard). Sign-in uses PKCE, so no client secret is needed.Descriptions are as written by the maker.
In the Spotify Soundtrack MCP settings, TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Spotify Soundtrack MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Spotify Soundtrack MCP or shows a Spotify Soundtrack MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SPOTIPY_REDIRECT_URI Redirect URI registered for your Spotify app. · default http://127.0.0.1:8888/callbackSPOTIFY_TOOLSETS Comma-separated toolsets to load: core, playback, playlists, search, taste, library, browse or all. · default coreDescriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user spotify-soundtrack --env SPOTIPY_CLIENT_ID=your-value --env TMDB_API_KEY=your-value --env TMDB_READ_ACCESS_TOKEN=your-value -- uvx spotify-soundtrack-mcp --transport stdioClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"spotify-soundtrack": {
"command": "uvx",
"args": [
"spotify-soundtrack-mcp",
"--transport",
"stdio"
],
"env": {
"SPOTIPY_CLIENT_ID": "your-value",
"TMDB_API_KEY": "your-value",
"TMDB_READ_ACCESS_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"spotify-soundtrack": {
"command": "uvx",
"args": [
"spotify-soundtrack-mcp",
"--transport",
"stdio"
],
"env": {
"SPOTIPY_CLIENT_ID": "your-value",
"TMDB_API_KEY": "your-value",
"TMDB_READ_ACCESS_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"spotify-soundtrack": {
"type": "stdio",
"command": "uvx",
"args": [
"spotify-soundtrack-mcp",
"--transport",
"stdio"
],
"env": {
"SPOTIPY_CLIENT_ID": "your-value",
"TMDB_API_KEY": "your-value",
"TMDB_READ_ACCESS_TOKEN": "your-value"
}
}
}
}SPOTIPY_CLIENT_ID required envSPOTIPY_REDIRECT_URI envTMDB_API_KEY secret required envTMDB_READ_ACCESS_TOKEN secret required envSPOTIFY_TOOLSETS envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
pypi: spotify-soundtrack-mcpBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026
The registry name was verified with the GitHub account Chiru144, which owns the repo
Code last changed 11 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for spotify-soundtrack-mcp@1.1.0
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/chiru144-spotify-soundtrack-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 11 days ago, and the latest version (1.1.0) reached the registry 14 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Build, edit and run courses, learning paths and communities in your LearnHouse academy.
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft serves real save game data and expert game knowledge to AI assistants.
| This one Spotify Soundtrack MCP | LearnHouse | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | Yes | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 5/5 | 4/4 | 3/3 | 4/4 | 3/4 |
| License | MIT | AGPL-3.0 | AGPL-3.0 | MIT | MIT | Apache-2.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
This repository contains a FastMCP application that connects Spotify with TMDB (The Movie Database). It has 115 registered MCP tools and 20 autonomous agent skills, and lets you build movie soundtrack playlists, automate playlist curation, explore your listening taste, and use a local web app, the Soundtrack Curator & Staging Studio.
[!NOTE]
Built mostly for Indian users. The project is designed around Indian film music: it builds playlists from an actor's filmography and matches soundtracks for Kannada, Telugu, Tamil, Malayalam and Hindi movies, including songs credited as 'From "Movie Name"' and releases tagged with a language, such as "[Kannada]". It works for any music on Spotify, but Indian cinema is where it is strongest.
playback.py, playlists.py, taste.py, search.py, library.py, library_cache.py, generators.py, browse.py, web_app.py), each covered by unit tests.In 2026, Spotify switched off several Web API features for apps in Development Mode, which is what every personal Client ID is. The tools work around them where they can:
| Spotify feature | Status | What the tools do instead |
|---|---|---|
| Related artists | Removed (403) | spotify_related_artists and get_artist_network list the artists who share the most songs with the artist. |
| Recommendations and genre seeds | Removed (404) | spotify_get_recommendations, get_recommendations and spotify_discover_by_artist recommend songs by the seeds' collaborators plus genre-search picks. spotify_genre_explorer lists a built-in set of genres. |
| Artist top tracks | Removed (403) | The artist's top search results are used instead. |
| Audio features (energy, valence, tempo...) | Removed (403) | get_audio_features and reorder_playlist_by_audio_features return an "unavailable" message. target_energy and target_valence pick the genres whose estimated energy and valence are closest; other target_* arguments are ignored. Moods map to genres. |
| Popularity, followers, genres | Returned as null | Shown as N/A or left out. spotify_discover_deep_cuts treats a "deep cut" as an album track outside the artist's top search results, and spotify_taste_profile reports artist variety and eras instead of a mainstream score. |
| Other users' profiles, follower checks and playlists you don't follow | Removed (403) | spotify_get_user and spotify_check_playlist_followers work for your own account only. |
Search limit above 10 | Rejected | The client fetches larger searches 10 results at a time. |
spotify_sync_library downloads your Liked Songs and the playlists you own into a JSON file: ~/.cache/spotify-mcp/library.json, or %LOCALAPPDATA%\spotify-mcp\library.json on Windows (set SPOTIFY_MCP_LIBRARY_PATH to change it). After that:
spotify_query_library and spotify_library_stats answer questions about your music without calling Spotify.spotify_vibe_playlist builds a playlist for a mood, or an energy/valence target, from songs you already like.spotify_era_playlist (with from_library=True) and spotify_time_capsule_playlist (songs you saved in a given year) also use the cache.spotify_radio_playlist mixes an artist's songs with songs by the artists they collaborate with.Every generator shows a preview first and only creates a playlist when called with create=True.
How vibes are estimated: Spotify no longer gives this app audio features or artist genres, so each genre has an estimated energy and valence (GENRE_VIBES in tools/discovery.py). A song gets its vibe from the genre searches its artist appears in, plus words in its track, album and playlist names ("Unplugged" means acoustic; a playlist called "Gym" means workout). Spotify's genre search mostly covers mainstream Western genres, so songs from other scenes, such as Kannada, Telugu or Tamil film music, are often left unplaced. Naming your playlists by mood helps.
Run spotify_sync_library again whenever your library changes. A sync makes about one Spotify call per 50 Liked Songs, plus one or more per playlist.
For an in-depth breakdown of the features, a feature comparison table, and the cinema filmography pipeline, see [CONTRIBUTING.md](CONTRIBUTING.md#features--technical-overview). The complete 115-tool catalog and the 20 agent skills are listed in [CONTRIBUTING.md](CONTRIBUTING.md#complete-fastmcp-tools-catalog-115-registered-tools).
The MCP server is listed in the official MCP Registry as `io.github.Chiru144/spotify-soundtrack-mcp` (metadata in server.json), so registry-aware MCP clients can find and install it. The server and the web studio are published as two Python packages:
| Package | What it gives you | Commands |
|---|---|---|
spotify-soundtrack-mcp | The MCP server with all 115 tools and 20 skills | spotify-mcp, spotify-soundtrack-mcp, spotify-mcp-auth |
spotify-mcp-web | The Soundtrack Curator & Staging Studio web app | soundtrack-studio |
pip install spotify-soundtrack-mcp spotify-mcp-web
You need Python 3.10 or later. Installing spotify-mcp-web also installs spotify-soundtrack-mcp. If you don't want the web studio, install only spotify-soundtrack-mcp.
Create ~/.spotify-mcp/.env (or a .env file in the folder you run the commands from):
SPOTIPY_CLIENT_ID=your_spotify_client_id
SPOTIPY_REDIRECT_URI=http://127.0.0.1:8888/callback TMDB_API_KEY=your_tmdb_api_key # or TMDB_READ_ACCESS_TOKEN=... SPOTIFY_TOOLSETS=core # optional: core (default), playback, playlists, search, taste, library, browse, all
In the Spotify Developer Dashboard, add http://127.0.0.1:8888/callback as a Redirect URI for your app. Only the Client ID is needed; there is no client secret.
spotify-mcp-auth
This opens Spotify in your browser. Once you approve, the token is saved to ~/.spotify-mcp/.spotipyoauthcache (set SPOTIFY_MCP_CACHE_PATH to store it elsewhere), and both the MCP server and the web studio use it.
spotify-mcp runs the server over stdio. Add it to Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) or any other MCP client:
{
"mcpServers": { "spotify": { "command": "spotify-mcp", "env": { "SPOTIFY_TOOLSETS": "core" } } } }
If the client can't find spotify-mcp on your PATH, use the full path printed by where spotify-mcp (Windows) or which spotify-mcp (macOS/Linux). With uv, you can skip the install and let the client run it:
{
"mcpServers": { "spotify": { "command": "uvx", "args": ["--from", "spotify-soundtrack-mcp", "spotify-mcp"] } } }
From version 1.1.0, the package-named command also runs over stdio when given --transport stdio. This is the command MCP Registry clients run:
{
"mcpServers": { "spotify": { "command": "uvx", "args": ["spotify-soundtrack-mcp", "--transport", "stdio"], "env": { "SPOTIPY_CLIENT_ID": "your_spotify_client_id" } } } }
While spotify-mcp is running, it also starts the web studio at http://127.0.0.1:8000 if spotify-mcp-web is installed.
To serve MCP over HTTP (SSE) for remote clients instead, run:
spotify-soundtrack-mcp
It listens on 0.0.0.0:8080; set HOST and PORT to change this. spotify-soundtrack-mcp --transport stdio (or MCP_TRANSPORT=stdio) runs it over stdio instead, and spotify-soundtrack-mcp --version prints the installed version.
soundtrack-studio
This starts the studio at http://127.0.0.1:8000 and opens your browser. Set PORT to use a different port, or OPEN_BROWSER=false to stop it from opening the browser. The tool guide is at /guide and the advanced tools are at /tools.
The Dockerfile builds the MCP server from this repository and runs it over stdio (MCP directories such as Glama use it to inspect the server):
docker build -t spotify-soundtrack-mcp .
docker run -i --rm -e SPOTIPY_CLIENT_ID=your_spotify_client_id -e TMDB_API_KEY=your_tmdb_api_key spotify-soundtrack-mcp
All 115 tools load by default (SPOTIFY_TOOLSETS=all); pass -e SPOTIFY_TOOLSETS=core for the smaller set.
To run from source instead of PyPI, make sure you have the following installed:
You will also need developer API credentials for:
Follow these steps to run the project locally:
git clone https://github.com/Chiru144/Spotify-MCP-Web-And-MCP-Server.git
cd Spotify-MCP-Web-And-MCP-Server
Using a virtual environment is recommended for managing dependencies.
Windows:
python -m venv .venv
.venv\Scripts\activate
Mac/Linux:
python3 -m venv .venv
source .venv/bin/activate
Install the required Python packages from requirements.txt:
pip install -r requirem