
Spotify Bulk Actions Mcp
io.github.khglynnPublished by GitHub account khglynnv0.1.1Updated Nov 10, 2026
MCP server for bulk Spotify operations - batch playlist creation, exports, management
The publisher's own server: actions.world
Overview
Local MCP server for bulk Spotify work: build playlists from song lists, clean up playlists, and export or analyze your library.
- What you can do
- Read library and listening data: followed artists, saved tracks, top artists and tracks, recently played, library summaries
- Search tracks, including fuzzy and batch search with HIGH/MEDIUM/LOW confidence scores
- Create playlists, add tracks, and import CSV song lists into new playlists
- Maintain playlists: compare, find and remove duplicates, bulk remove, reorder, update details, export to CSV
- Bulk follow or unfollow artists and save or unsave tracks
- Validate song CSVs and export uncertain matches for human review
- When to use it
- Useful when you want an assistant to turn a long list of songs (for example from podcast show notes) into a Spotify playlist, to clean up or compare existing playlists, or to get statistics about your saved library and listening history.
- Requirements
- Runs locally as a Python package (Python 3.10+) installed from PyPI or the repo. Needs a Spotify account and a Spotify developer app with SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET set in a local .env file, plus a one-time browser login that stores tokens in a local cache directory. Network access to the Spotify API is required.
Installation
In SourceWeft
- Open Spotify Bulk Actions Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
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!
Source: README.md at commit 97dba94
Tools
0Version history
1- v0.1.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Other Actions integrations
actions.world
world.actionsOfficial publisher
Remote MCP server that lets an assistant run video actions on actions.world datasets and track the resulting runs.

Meeting decisions and actions extract — Atom
org.aimlds
Meeting decisions and actions extract — Atom's hosted MCP server, published by aimlds.org; credential required; Streamable HTTP.

MCP Safe Actions
Published by GitHub account techsaurabh-394
File server whose delete tool asks a human first (elicitation or one-time token), with audit log.

Apple Mail Actions
Published by GitHub account redpop
A macOS-only companion server that lets an assistant move Apple Mail messages between mailboxes and optionally save a single attachment to a local folder.

NSE Corporate Announcements (Apify) - NSE India filings, corporate actions, bulk and block deals
Published by GitHub account datadmon
Apify-hosted MCP server that lets an assistant pull NSE India corporate filings as JSON: announcements, ex-dates, board meetings, bulk and block deals, ratings.