
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 公司公告、除息日、董事會會議、大宗與鉅額交易及評等資料。