SpotiPy MCP

An MCP server for searching Spotify and managing your playlists from Claude (or any MCP client). Built on spotipy.

Features

Search

• search_tracks, search_artists, search_albums (supports advanced filters like artist:, year:, genre:)

• get_track_details, get_artist_top_tracks

Playlist management

• list_my_playlists, get_playlist_tracks

• add_tracks_to_playlist, remove_tracks_from_playlist

• create_playlist, delete_playlist — delete a playlist you own

• unfollow_playlist — remove a playlist (typically one you don't own) from your library without deleting it

• search_and_add — find the top match for a query and add it in one step

Related MCP server: Spotify MCP Server

Setup

1. Install dependencies

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

2. Register the redirect URI

In the Spotify Developer Dashboard, open your app → Settings → Redirect URIs, and add:

http://127.0.0.1:8888/callback

(Must match SPOTIFY_REDIRECT_URI in .env.)

3. Authorize once

python auth_setup.py

A browser window opens; log in and grant access. A refresh token is cached to .cache so you never have to log in again (the server refreshes it silently).

4. Register with Claude Desktop / Claude Code

Add this to your MCP client config (for Claude Desktop, claude_desktop_config.json). Use absolute paths:

{
  "mcpServers": {
    "spotipy": {
      "command": "~\\SpotiPy\\.venv\\Scripts\\python.exe",
      "args": ["~\\SpotiPy\\server.py"]
    }
  }
}

For Claude Code:

claude mcp add spotipy -- "~\SpotiPy\.venv\Scripts\python.exe" "~\SpotiPy\server.py"

Restart the client, and the SpotiPy MCP tools become available.

Configuration (.env)

Security notes

• .env and .cache hold secrets and are git-ignored. Do not commit them.

• If your client secret was ever exposed, rotate it in the Spotify dashboard.

Note on discovery endpoints

Spotify deprecated the Recommendations, Audio Features, Audio Analysis, and Related Artists endpoints for newly-created apps (Nov 2024). SpotiPy MCP therefore relies on search filters and get_artist_top_tracks for discovery rather than those endpoints.