
Spotify Bulk Actions Mcp
io.github.khglynn由 GitHub 账号 khglynn 发布v0.1.1更新于 Nov 10, 2026
MCP server for bulk Spotify operations - batch playlist creation, exports, management
发布方自己的服务:actions.world
概览
本地 MCP 服务器,用于批量处理 Spotify:从歌曲清单创建播放列表、清理播放列表,以及导出和分析你的音乐库。
- 可以做什么
- 读取音乐库与收听数据:关注的艺人、收藏歌曲、常听艺人与曲目、最近播放、音乐库汇总
- 搜索曲目,包括模糊搜索和带高/中/低置信度评分的批量搜索
- 创建播放列表、添加曲目,并把 CSV 歌曲清单导入为新播放列表
- 维护播放列表:比较、查找并删除重复曲目、批量移除、重新排序、更新信息、导出为 CSV
- 批量关注或取消关注艺人,批量收藏或取消收藏曲目
- 校验歌曲 CSV,并导出不确定的匹配结果供人工复核
- 适用场景
- 适合让助手把一长串歌曲(例如播客节目笔记中的歌单)整理成 Spotify 播放列表,清理或比较已有播放列表,或统计你收藏的音乐库和收听记录。
- 运行要求
- 以本地 Python 包形式运行(需 Python 3.10+),可从 PyPI 或代码仓库安装。需要 Spotify 账号和 Spotify 开发者应用,在本地 .env 文件中设置 SPOTIFY_CLIENT_ID 与 SPOTIFY_CLIENT_SECRET,并完成一次浏览器登录,令牌保存在本地缓存目录。需要访问 Spotify API 的网络连接。
安装
在 SourceWeft 中
- 打开 控制台中的 Spotify Bulk Actions Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
Spotify Bulk Actions MCP
A Model Context Protocol (MCP) server for bulk Spotify operations - batch playlist creation, library exports, and large-scale library management.
What makes this different from other Spotify MCPs?
- Confidence scoring - Batch searches return HIGH/MEDIUM/LOW confidence for each match
- Human-in-the-loop - Uncertain matches are exported for review, then re-imported
- Bulk operations - Handle 500+ songs efficiently with rate limiting built-in
- Library exports - Export your complete library data
- Podcast playlist focused - Built specifically for importing song lists from podcast show notes
Support This Project
Made cause I can't not have headphones on, support my 80k+ pocast subscriptions. [Buy Me A Coffee]
Listed On
Projects I've Built With This
Playlists Maintained With This MCP
Coming soon: Switched On Pop, This American Life, and more podcast playlists
What This Does
Library Analysis:
- Get all your followed artists
- Get all saved/liked songs (handles libraries up to 10k songs)
- Find unique artists from your library ranked by song count
- Find albums where you have 6+ saved songs (great for vinyl shopping!)
- Export your complete library summary
Listening Insights:
- Your top artists and tracks (short/medium/long term)
- Recently played history
Bulk Playlist Creation:
- Import song lists from CSV files (for podcast playlists, etc.)
- Batch search with confidence scoring (HIGH/MEDIUM/LOW)
- Automatic handling of uncertain matches for human review
- Create playlists from search results
Playlist Maintenance:
- Find and remove duplicate tracks
- Compare two playlists (shared vs unique tracks)
- Bulk remove and reorder tracks, update playlist details
- Export any playlist to CSV
Bulk Library Actions:
- Follow/unfollow artists in bulk
- Save/unsave tracks in bulk
Quick Start
1. Prerequisites
- Python 3.10+
- A Spotify account
- Spotify Developer credentials (get them here)
2. Clone & Setup
Also on PyPI:
pip install spotify-bulk-actions-mcp- but you'll still need local.envand auth setup.
3. Authenticate with Spotify (One-Time)
This opens a browser for you to log in:
After login, your token is saved locally in .spotify_cache/.
4. Test It Works
Option B: Hosted (claude.ai custom connector)
This server also runs as a remote MCP over streamable HTTP (MCP_TRANSPORT=http),
fronted by OAuth 2.1 (WorkOS AuthKit) with a fail-closed user allowlist. That's how
the author runs it: Cloud Run + Secret Manager for the Spotify refresh token, added
to claude.ai as a custom connector. Tools carry readOnlyHint/destructiveHint
annotations so clients can group read vs write actions. See Dockerfile and the
deploy notes in the parent collection repo.
5. Connect to Claude Code
Add this to your Claude Code settings (~/.claude/settings.local.json):
Restart Claude Code after adding this.
Available Tools (33)
Library Analysis
Listening Insights
Bulk Library Actions
Search
Playlist Creation
Playlist Management
Utilities
How This Differs From the Official Spotify Connector
Claude has an official Spotify connector (built by Spotify, April 2026). It's excellent at what it does — but its tool surface is small, and this MCP exists for everything it doesn't cover. As of August 2026 the official connector exposes 8 tools: Search Spotify, Create Playlist, Get Currently Playing, Add to Library, Remove from Library, Fetch Playlist Tracks, and two auth utilities.
One more difference: the official connector runs on Spotify's partner-gated MCP gateway (no dynamic client registration; tokens from ordinary developer apps are rejected), so it's only usable inside partnered AI surfaces. This MCP runs under your own Spotify developer app — Development Mode limits apply (5 allowlisted users per Client ID as of February 2026), but you control it end to end.
Example Workflows
Get Your Library Stats
Ask Claude:
"What artists do I have the most saved songs from?"
Claude will use get_library_artists and show you.
Find Albums for Vinyl
Ask Claude:
"Find albums where I have 6 or more saved songs"
Claude will use get_albums_by_song_count with min_songs=6.
Create Playlist from Song List
- Create a CSV file:
- Ask Claude:
"Create a playlist called 'My Mix' from this CSV: [paste CSV]"
Claude will:
- Parse the CSV
- Search each song with confidence scoring
- Create the playlist with high-confidence matches
- Show you uncertain matches to review
Bulk Podcast Playlist
For large lists (500+ songs):
- Ask Claude to use
batch_search_trackswith your song list - Review the results (HIGH goes in automatically)
- Use
export_review_csvto get uncertain matches - Review/correct in a spreadsheet
- Use
add_reviewed_tracksto add your corrections
Rate Limits
The server handles Spotify's rate limits automatically:
- Small delays between API calls
- Automatic retry on 429 errors
- Caching to reduce repeat calls
For 10k songs, expect the initial library fetch to take 2-3 minutes.
Files & Data
Troubleshooting
"Not authenticated" error:
Rate limit errors: Wait a few minutes and try again. The server will auto-retry.
Token expired:
The server auto-refreshes tokens. If issues persist, re-run setup_auth.py.
Security Notes
- Your credentials are in
.env(gitignored, never committed) - Auth tokens are stored locally in
.spotify_cache/ - Never share your
.envor token files - If credentials are exposed, rotate them in Spotify Dashboard
License
MIT
Made cause I can't not have headphones on. If this helps you, buy me a coffee!
来源:README.md,提交 97dba94
工具
0版本历史
1- v0.1.1最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
其他 Actions 集成
actions.world
world.actions官方发布者
远程 MCP 服务器,让助手在 actions.world 数据集上运行视频操作并跟踪运行结果。

Meeting decisions and actions extract — Atom
org.aimlds
Meeting decisions and actions extract — Atom 的托管 MCP 服务,由 aimlds.org 发布;需要凭据;Streamable HTTP。

MCP Safe Actions
由 GitHub 账号 techsaurabh-394 发布
文件服务器,其删除工具会先询问人工确认(引导确认或一次性令牌),并带有审计日志。AI 翻译

Apple Mail Actions
由 GitHub 账号 redpop 发布
仅限 macOS 的配套服务器,让助手在 Apple Mail 中把邮件移动到其他邮箱,并可选地把单个附件保存到本地文件夹。

NSE Corporate Announcements (Apify) - NSE India filings, corporate actions, bulk and block deals
由 GitHub 账号 datadmon 发布
托管在 Apify 上的 MCP 服务器,让助手以 JSON 获取印度 NSE 公司公告、除权日、董事会会议、大宗与批量交易及评级数据。