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

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

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

Quick Start

1. Prerequisites

• Python 3.10+
• A Spotify account
• Spotify Developer credentials (get them here)

2. Clone & Setup

# Clone the repo
git clone https://github.com/khglynn/spotify-bulk-actions-mcp.git
cd spotify-bulk-actions-mcp

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
pip install -e .

# Copy env example and add your credentials
cp .env.example .env
# Edit .env with your SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET

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:

python setup_auth.py

After login, your token is saved locally in .spotify_cache/.

4. Test It Works

source venv/bin/activate
python -c "from src.utils.auth import is_authenticated; print('Auth OK!' if is_authenticated() else 'Not authenticated')"

5. Connect to Claude Code

Add this to your Claude Code settings (~/.claude/settings.local.json):

{
  "mcpServers": {
    "spotify": {
      "command": "/path/to/spotify-bulk-actions-mcp/venv/bin/python",
      "args": ["/path/to/spotify-bulk-actions-mcp/src/server.py"]
    }
  }
}

Restart Claude Code after adding this.

Available Tool

... View full README on GitHub