Spotify MCP server
io.github.XavierFabregat/spotify-mcp·v0.1.2Conversational Spotify control from AI clients: play, queue, devices, playlists, and library.
0 stars107 downloads/wk
Reviews
Write oneNobody has reviewed Spotify yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Spotify tools (11)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
authenticateConnects the user's Spotify account via OAuth. Opens a browser on this machine for
devicesaction=list shows available Spotify devices; action=transfer moves playback to a device
get_playlist_itemsLists the tracks in one of the user's own or collaborative playlists
get_playlistsLists the user's playlists with item counts and URIs.
librarySaves, removes, or checks items in the user's Spotify library ('liked'). Works with any
modify_playlistaction=create makes a new playlist (private by default); action=add_items appends
now_playingCurrent track, artist, album, progress, device, and shuffle/repeat state.
playPlays music by free-text query (searches and starts the best match) or by Spotify URI.
playbackTransport controls for the active playback: pause, resume, next, previous,
queueaction=add queues a track by query or URI; action=list shows what's playing and up next.
searchSearches the Spotify catalog. Use when the user wants options to choose from;
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan12 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 23 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Spotify compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 90% of 1,337 Media servers
- Tools
- 11
- the typical Media server has 7
- Tools that change things
- 0%
- typical: 5%. Fewer write tools means less an agent can break
- Downloads a week
- 107
- more than 65% of 358 Media servers with a package
What its tools let an agent do: 10 read · 1 change
Install Spotify in Claude Code, Cursor or VS Code
Runs npx -y @xavifabregat/spotify-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add spotify-mcp -- npx -y @xavifabregat/spotify-mcp
What the publisher says
From the Spotify repository's README, as published. We do not edit it. Read it on GitHub
spotify-mcp
Control Spotify by talking to your AI. An MCP server for Claude Desktop, Claude Code, Cursor, and any other MCP client.
You: play something like early Bill Evans
AI: ▶ Now playing: "Peace Piece" — Bill Evans · Everybody Digs Bill Evans
You: perfect, queue the whole album and save this one
AI: ➕ Queued Everybody Digs Bill Evans · ❤️ Saved "Peace Piece" to your library
Built against the current (post-February-2026) Spotify Web API — many older Spotify MCP servers predate those changes and are partially broken.
Requirements
for creating the developer app you'll use.
- Spotify Premium — Spotify requires it for playback control and (since Feb 2026)
- Node.js ≥ 20
Quick start
npx -y @xavifabregat/spotify-mcp initThe wizard walks you through creating your own (free) Spotify developer app, asks for its Client ID, and opens a browser to connect your account — about 2 minutes total.
Why your own app? Spotify caps third-party apps at a handful of users, so every user brings their own; the wizard makes that painless. No client secret is involved (PKCE). Tokens stay in ~/.spotify-mcp/ on your machine and refresh silently.
The one detail that must be exact — your app's Redirect URI:
http://127.0.0.1:8888/callbackAdd to your MCP client
Claude Code
claude mcp add -s user spotify -- npx -y @xavifabregat/spotify-mcpClaude Desktop (~/Library/Application Support/Claude/claudedesktopconfig.json) or Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"spotify": {
"command": "npx",
"args": ["-y", "@xavifabregat/spotify-mcp"]
}
}
}Restart the client and start talking.
Tools
Design
the server searches, picks the best match, starts playback, and reports what it chose so you can correct it. No search → choose → play round trips.
- Tools are intents, not endpoints. "Play some Radiohead" is one tool call —
accurate across different AI clients and context lean.
- Small surface. 11 tools instead of one per API endpoint keeps tool selection
chain without re-searching. Raw API payloads never reach the model.
- Responses are compact text with Spotify URIs, so follow-ups ("queue that")
says how to pick one. Not logged in? It points at the authenticate tool. The model relays the fix instead of a stack trace.
- Errors are instructions. No active device? The response lists your devices and
Troubleshooting
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Spotify: common questions
- Is Spotify MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Spotify safety report
- How do I install Spotify?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Spotify need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Spotify maintained?
- The last commit was 60 days ago (2026-09-03). The latest release is v0.1.2.
- What can I use instead of Spotify?
- Servers from other publishers that do the same job: smartest-tv MCP server, FunASR MCP server and Transcription MCP server.
- How does Spotify compare with other Media MCP servers?
- safety score 92/100 (higher than 90% of 1,337 Media servers); tools 11 (the typical Media server has 7); tools that change things 0% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Spotify
Same job from other publishers: the closest match first, then the best rated.
- smartest-tvControl any smart TV with natural language. Resolve Netflix/YouTube/Spotify and deep-link.not reviewedGrowingA
- FunASRTranscribe local audio with FunASR and SenseVoice using private, on-device inference.not reviewedEstablishedA
- TranscriptionTranscribe audio and video and work with your transcript library from any AI app. 119 languages.not reviewedGrowingA
Spotify Trends MCPSpotify podcast and artist trends over time, with growth metrics. Free key at trendsmcp.ainot reviewedGrowingA- AdyenMCP server for Adyen Checkout API v71 — enterprise payments (iFood, Uber, Spotify in LatAm)not reviewedGrowingB