Skip to content
MCP server

Spotify

Search, play and manage Spotify playlists and your library from an MCP client

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
0.9.2
Listing updated
today

Similar MCP servers

About Spotify

Spotify is a free MCP server for events and entertainment. It runs locally on your machine and is started by your AI client.

This local Python server drives your own Spotify account through 48 tools, six resources and five prompts. It is a maintained fork of an earlier Spotify MCP project, and a TypeScript edition exists for hosted use.

Setup needs Python 3.12+, uv and your own Spotify developer app, with its client ID, secret and a 127.0.0.1:8888 redirect URI. Playback needs Spotify Premium and an available Connect device. First use opens a browser for authorisation, and the token is cached locally.

The design leans on large libraries: playlist reads return up to 1,000 tracks per call with a continuation offset, library writes are batched in groups of 40, and removals ask for confirmation where the client supports it. New playlists default to private. The README warns that batch writes are not atomic and that Spotify's developer-mode quotas limit how many users an app can serve.

Install

Run in a terminal

claude mcp add spotify-mcp --env SPOTIFY_CLIENT_ID='<SPOTIFY_CLIENT_ID>' --env SPOTIFY_CLIENT_SECRET='<SPOTIFY_CLIENT_SECRET>' --env SPOTIFY_REDIRECT_URI='<SPOTIFY_REDIRECT_URI>' -- uvx spotify-mcp-jamiew

Add to claude_desktop_config.json

{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "spotify-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SPOTIFY_CLIENT_IDSpotify app Client ID from developer.spotify.comRequired
  • SPOTIFY_CLIENT_SECRETSpotify app Client Secret from developer.spotify.comRequired
  • SPOTIFY_REDIRECT_URIOAuth redirect URI registered in your Spotify appRequired

Tools this server provides (17)

Taken from the project documentation; the running server may differ.

get_me
Read your profile.
search_music
Search tracks, albums, artists or playlists with filters.
control_playback
Play, pause, skip, seek, volume, shuffle and repeat.
list_devices
List Spotify Connect devices.
transfer_playback
Move playback to another device.
get_queue
Read now playing and upcoming items.
add_to_queue
Queue a track or episode.
list_playlists
List your playlists.
get_playlist_tracks
Read up to 1000 playlist tracks per call.
create_playlist
Create a private playlist.
add_tracks_to_playlist
Add up to 100 tracks or episodes.
remove_tracks_from_playlist
Remove tracks with confirmation where supported.
reorder_playlist
Move a block of tracks.
get_saved_tracks
Read Liked Songs.
save_tracks
Like tracks.
get_top_items
Read top artists or tracks over a time range.
get_recently_played
Read recently played tracks with timestamps.

What it does

48 tools
Covers search, playback, queue, playlists and library.
Large playlist reads
Pages up to 1,000 tracks per call.
Safe edits
Confirmations and snapshot guards for removal and reordering.
Library management
Saves tracks, albums, shows, episodes and audiobooks.
Listening history
Reads top items and recently played.

Good for

  • Build a playlist from a text description
  • Control playback on a Connect device
  • Clean up Liked Songs in bulk
  • Review top artists over a time range

Pricing

Free

Free; Spotify Premium needed for playback

Spotify FAQ

What do I need?

Python 3.12+, uv, a Spotify developer app and Premium for playback.

Are new playlists public?

No, they default to private.

Are bulk writes atomic?

No; earlier changes may remain after an error.

Where does the token live?

Cached locally after browser authorisation.

Is Spotify free?

Yes. Spotify is free to use.

How do I add Spotify to Claude Code?

Run this command in your terminal: claude mcp add spotify-mcp --env SPOTIFY_CLIENT_ID='<SPOTIFY_CLIENT_ID>' --env SPOTIFY_CLIENT_SECRET='<SPOTIFY_CLIENT_SECRET>' --env SPOTIFY_REDIRECT_URI='<SPOTIFY_REDIRECT_URI>' -- uvx spotify-mcp-jamiew

What are the best alternatives to Spotify?

The closest alternatives to Spotify are Dostuff, Skiddle, Madrid Events, Nyc Parks and Edmtrain.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers