khglynn/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.
---
Listed On
| Directory | Link |
|-----------|------|
| PyPI | pypi.org/project/spotify-bulk-actions-mcp |
| mcp.so | mcp.so/server/spotify-bulk-actions-mcp |
| awesome-mcp-servers | PR #1541 *(pending)* |
---
Projects I've Built With This
| Project | Description | Links |
|---------|-------------|-------|
| **recordOS** | Which albums do you love most? A visual album collection app | Live · Repo |
| **Festival Navigator** | Navigate multi-day festivals with friends | Repo |
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 .env and 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
| Tool | Description |
|------|-------------|
| check_auth_status | Verify Spotify auth is working |
| get_followed_artists | Get all artists you follow |
| get_saved_tracks | Get all your liked songs |
| get_library_artists | Artists from saved songs, ranked by count |
| get_albums_by_song_count | Albums with N+ saved songs |
| export_library_summary | Complete library export |