Spotify MCP Server

A Model Context Protocol server that lets Cursor, Claude, and other AI assistants control Spotify playback, manage playlists, and plan DJ sets from BPM, key, and energy data. Ships with the agent skills that drive those tools.

Started from marcelmarais/spotify-mcp-server and since rewritten from scratch. Follow this setup, not upstream's. MIT licensed.

Example interactions

• "Play Elvis's first song"

• "Create a Taylor Swift / Slipknot fusion playlist"

• "Copy the techno tracks from my workout playlist into my work playlist"

• "Reorder my house playlist into a set that warms up, peaks, then cools down"

• "What's the BPM and key of everything in this playlist?"

Related MCP server: Spotify MCP Server

What it does

Playback control, search, playlist and album editing, and listening history through 30 tools. See Tools.

On top of that sit the DJ tools. analyzeDjPlaylist reads BPM, Camelot key, and playlist-relative energy for a playlist and names the source behind every value. planDjSet turns that into a set order you can review, honouring harmonic mixing, an energy curve, artist spacing, and anchors you pin by hand. applyDjSetPlan writes it, defaulting to a dry run, checking the snapshot before and after, and keeping a receipt so a half-applied reorder rolls back. See DJ sets.

Quick start

You need Node.js 18+, a Spotify Premium account, and a Spotify Developer app with http://127.0.0.1:8888/callback registered as a Redirect URI.

git clone https://github.com/martin-gomola/spotify-mcp-server.git
cd spotify-mcp-server
npm install && npm run build
cp spotify-config.example.json spotify-config.json  # add your client ID and secret
npm run auth

Then point your client at build/index.js. Setup covers each step, the client config for Claude Desktop, Cline, and Cursor, and the optional SoundNet key.

Documentation