MCP Claude Spotify

A Spotify MCP server for Claude Desktop: music search, playback and playlist control and listening history.

  • 53 ★ on the repository
  • Last commit
  • MPL-2.0
MCP server

Extended access

Why this level

  • The server controls playback and edits playlists on your Spotify account.
  • Access tokens are stored in a file on your computer.
All reasons and checks

imprvhub/mcp-claude-spotify

Install

Manual install

npx -y @smithery/cli@latest mcp add imprvhub/mcp-claude-spotify --client claude

Automatic install through Smithery, the manual way is described in the README.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The server controls playback and edits playlists on your Spotify account.
  • Access tokens are stored in a file on your computer.

This is third-party code. Review the repository files before installing.

What it does

MCP Claude Spotify connects Spotify to Claude Desktop through MCP. After authorization the assistant searches tracks, albums, artists and playlists, controls playback (play, pause, next, previous) and fully manages playlists: creates, edits, deletes, reorders tracks and changes covers. It also shows your top played tracks over different periods and recent plays. The `get-recommendations` tool was removed in version 0.6.0 because Spotify closed that endpoint on 27 November 2024. Use `search-spotify` and `get-top-tracks` instead. Tokens are saved in `~/.spotify-mcp/tokens.json` and sign-in uses OAuth with the Client ID and Client Secret of your Spotify app.

Who it is for. Spotify and Claude Desktop users who want to run music and playlists through conversation with the assistant.

Good fit when

  • The assistant builds a playlist from found tracks for a described mood.
  • While working you ask for the next track or a pause.
  • You check top tracks for the month and recently played.
  • You tidy a playlist: reorder, remove extras, change the cover.

Not a fit when

  • You need Spotify recommendations because the endpoint is closed.
  • You have no Spotify account or developer app.
  • The client is not Claude Desktop.

Example request

Find my most played tracks this month and build a new "Morning" playlist from them without duplicates.

MCP

Transport
stdio
Authentication
OAuth

Environment variables

SPOTIFY_CLIENT_ID required
Spotify app Client ID.
SPOTIFY_CLIENT_SECRET required, secret
Spotify app Client Secret.
SPOTIFY_AUTO_AUTH
Set to true to open the Spotify login on start when no tokens are stored.

Limitations

You need Node.js 20 or newer, a Spotify account, Claude Desktop and an app in the Spotify Developer Dashboard with a Client ID, Client Secret and the callback `http://127.0.0.1:8888/callback`. Recommendations, related artists, audio features and 30 second previews are unavailable because Spotify closed those endpoints in November 2024. The server controls playback and edits playlists on your account, so grant the assistant only the rights it needs.

How to disable. Remove the entry from `claude_desktop_config.json`, delete `~/.spotify-mcp/tokens.json` and revoke the app access in Spotify settings.

FAQ

How do I install the server?

Through Smithery with `npx -y @smithery/cli@latest mcp add imprvhub/mcp-claude-spotify --client claude` or manually: clone the repository, run `npm install` and `npm run build` if needed.

How do I get Spotify credentials?

Create an app in the Spotify Developer Dashboard, set the callback `http://127.0.0.1:8888/callback` and copy the Client ID and Client Secret.

How do I sign in to Spotify?

Ask Claude to authenticate and the `auth-spotify` tool runs. Or start the server once with `SPOTIFY_AUTO_AUTH=true`.

Why are there no recommendations?

`get-recommendations` was removed in version 0.6.0 because Spotify closed the endpoint. Use `search-spotify` and `get-top-tracks`.

Where are tokens stored?

In `~/.spotify-mcp/tokens.json` on your computer.

Discussion

No questions or reviews yet.

A Spotify MCP server: the agent searches music, controls playback, queue and volume, and builds and edits playlists and the library

MCP serverBroad access506Repository stars

A Python library and MCP server that give an agent public Spotify data, lyrics and transcripts with no API key

MCP serverExtended access325Repository stars
Russian stack

An MCP server for a local Rust-based Yandex Music player and sync daemon on Linux: playback control, taste profile, mood picks

MCP serverBroad access

An MCP server with 72 tools for FL Studio 2025: mix diagnosis, plugins, piano roll, routing and MIDI export for Claude

MCP serverExtended access137Repository stars

README in short

The README lists features, requirements, getting Spotify credentials and two ways to run. A separate note reports the removal of the recommendations tool.

README badge

Report a problem