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.
作者提供的原文
列表按使用分(满分 100)排序,由以下部分组成
| 热度 | 9/80 | GitHub 星标或每周下载量:较大的计 60,较小的计 20 |
|---|---|---|
| 新鲜度 | 12/12 | 30 天内有发布或代码更新得满分 |
| 仍在响应 | 0/8 | 上次检查时云端端点有响应 |
| 使用分 | 21/100 |
质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)
选择你使用的 AI 应用,然后复制设置。
用一句话让 AI 帮你安装
请帮我安装 Spotify Soundtrack MCP。按照 https://mcp.popnx.com/i/chiru144-spotify-soundtrack-mcp.md 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 3/3 项检查 · 在你的电脑上运行 · ✓ 命令已检查 2026年11月14日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
把这段话复制到 Claude 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Claude 安装 MCP server Spotify Soundtrack MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 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) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Spotify Soundtrack MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --versionMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version
安装一次,所有需要 uv 的工具都能用
打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
SPOTIPY_CLIENT_ID Client ID of your Spotify app (https://developer.spotify.com/dashboard). Sign-in uses PKCE, so no client secret is needed.说明仍为英文原文。
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"
}
}
}
}只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 Spotify Soundtrack MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Spotify Soundtrack MCP,或回答中出现 Spotify Soundtrack MCP 的工具名称,就表示连接成功
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
SPOTIPY_REDIRECT_URI 为您的 Spotify 应用注册的重定向 URI。 SPOTIFY_TOOLSETS 要加载的工具集,以逗号分隔:core、playback、playlists、search、taste、library、browse 或 all 说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 Spotify Soundtrack MCP
Spotify Soundtrack MCP 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器
A · 使用能连接 Spotify Soundtrack MCP 的应用
B · 游戏、体育、美食与学习 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
可连接 Claude Code,但需要先准备
需要 Spotify Soundtrack MCP 的密钥(在开发者网站创建) · 需要填写 1 项设置(SPOTIPY_CLIENT_ID) · 需要先在电脑上安装 Python (uv)(只需一次)
把这段话复制到 Claude Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Claude Code 安装 MCP server Spotify Soundtrack MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 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) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Spotify Soundtrack MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --versionMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version
安装一次,所有需要 uv 的工具都能用
打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
SPOTIPY_CLIENT_ID Client ID of your Spotify app (https://developer.spotify.com/dashboard). Sign-in uses PKCE, so no client secret is needed.说明仍为英文原文。
Mac:按 Command+空格,输入 Terminal · Windows:打开 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 stdio按 Enter 前,把“your-value”改成你的密钥
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
应能看到 Spotify Soundtrack MCP 在列表中并显示已连接
用 Spotify Soundtrack MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Spotify Soundtrack MCP,或回答中出现 Spotify Soundtrack MCP 的工具名称,就表示连接成功
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
SPOTIPY_REDIRECT_URI 为您的 Spotify 应用注册的重定向 URI。 SPOTIFY_TOOLSETS 要加载的工具集,以逗号分隔:core、playback、playlists、search、taste、library、browse 或 all 说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor,但需要先准备
需要 Spotify Soundtrack MCP 的密钥(在开发者网站创建) · 需要填写 1 项设置(SPOTIPY_CLIENT_ID) · 需要先在电脑上安装 Python (uv)(只需一次)
把这段话复制到 Cursor 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Cursor 安装 MCP server Spotify Soundtrack MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 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) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Spotify Soundtrack MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --versionMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version
安装一次,所有需要 uv 的工具都能用
打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
SPOTIPY_CLIENT_ID Client ID of your Spotify app (https://developer.spotify.com/dashboard). Sign-in uses PKCE, so no client secret is needed.说明仍为英文原文。
在 Spotify Soundtrack MCP 的设置中,TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 Spotify Soundtrack MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Spotify Soundtrack MCP,或回答中出现 Spotify Soundtrack MCP 的工具名称,就表示连接成功
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
SPOTIPY_REDIRECT_URI 为您的 Spotify 应用注册的重定向 URI。 SPOTIFY_TOOLSETS 要加载的工具集,以逗号分隔:core、playback、playlists、search、taste、library、browse 或 all 说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code,但需要先准备
需要 Spotify Soundtrack MCP 的密钥(在开发者网站创建) · 需要填写 1 项设置(SPOTIPY_CLIENT_ID) · 需要先在电脑上安装 Python (uv)(只需一次)
把这段话复制到 VS Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 VS Code 安装 MCP server Spotify Soundtrack MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 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) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Spotify Soundtrack MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --versionMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version
安装一次,所有需要 uv 的工具都能用
打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
SPOTIPY_CLIENT_ID Client ID of your Spotify app (https://developer.spotify.com/dashboard). Sign-in uses PKCE, so no client secret is needed.说明仍为英文原文。
在 Spotify Soundtrack MCP 的设置中,TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN, SPOTIPY_CLIENT_ID 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 Spotify Soundtrack MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Spotify Soundtrack MCP,或回答中出现 Spotify Soundtrack MCP 的工具名称,就表示连接成功
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
SPOTIPY_REDIRECT_URI 为您的 Spotify 应用注册的重定向 URI。 SPOTIFY_TOOLSETS 要加载的工具集,以逗号分隔:core、playback、playlists、search、taste、library、browse 或 all 说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
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 必填 envSPOTIPY_REDIRECT_URI envTMDB_API_KEY 机密 必填 envTMDB_READ_ACCESS_TOKEN 机密 必填 envSPOTIFY_TOOLSETS env说明为自动翻译,变量名保持原样;不确定时请查看原文。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月20日
注册名称已通过 GitHub 账户 Chiru144 验证,该账户拥有此仓库
代码最后更新于11天前
使用 MIT
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
OSV.dev 中没有 spotify-soundtrack-mcp@1.1.0 的记录
只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/chiru144-spotify-soundtrack-mcp)提问、分享技巧或报告无法使用。按“有帮助”数量排序。
还没有评价
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
你需要填写:TMDB_API_KEY, TMDB_READ_ACCESS_TOKEN
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
GitHub 仓库最后更新于11天前,最新版本(1.1.0)于14天前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。
同一分类中有:LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
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.
| 本项 Spotify Soundtrack MCP | LearnHouse | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | |
|---|---|---|---|---|---|---|
| 运行位置 | 需要安装在电脑上 | 在云端运行,无需安装 | 在云端运行,无需安装 | 需要安装在电脑上 | 在云端运行,无需安装 | 在云端运行,无需安装 |
| 需要密钥 | 是 | 否 | 否 | 否 | 是 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 否 | 否 | 否 |
| 基础检查 | 3/3 | 5/5 | 4/4 | 3/3 | 4/4 | 3/4 |
| 许可证 | MIT | AGPL-3.0 | AGPL-3.0 | MIT | MIT | Apache-2.0 |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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