Spotify MCP Server

Works with Codex, Cursor, Claude, Cline, and other MCP clients. The repository also ships the agent skills that guide setup, playlist curation, and DJ set planning.

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

Start here

Codex

Install the plugin with two commands:

codex plugin marketplace add martin-gomola/spotify-mcp-server --ref main
codex plugin add spotify-controller@spotify-mcp-server

Then tell Codex:

Set up Spotify for me. Do the technical parts yourself and tell me only what you need from my Spotify account.

The setup skill handles the local install and authentication, asking only for the Client ID and Client Secret from your Spotify app. See the Spotify Controller guide for the two-minute walkthrough.

Other MCP clients

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. Spotify's current Development Mode requires the app owner to have Premium; playback also needs Spotify open on an available device.

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. The setup guide has configuration for Claude Desktop, Cline, and Cursor. BPM and key need nothing extra: they come from ReccoBeats, which takes no key.

Related MCP server: Spotify MCP Server

Try asking

• "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?"

What it does

The server covers playback control, search, playlist and album editing, and listening history through a focused MCP toolset. See the core tool reference; audio analysis and DJ tools are documented separately under DJ sets.

Its DJ workflow goes further:

1. analyzeDjPlaylist reads BPM, Camelot key, and playlist-relative energy, naming the source behind every value.

2. planDjSet creates a reviewable set order with harmonic mixing, a shaped energy curve, artist spacing, and anchors you pin by hand.

3. applyDjSetPlan writes the approved order. It defaults to a dry run, checks the playlist snapshot before and after, and keeps a receipt so a half-applied reorder rolls back.

See DJ sets for the full analyze, plan, apply, and restore flow.

Documentation