MCP Connector

Control Spotify Playback with Claude

An inactive but functional MCP server connecting Claude to Spotify for playback control, search, queue, and playlist management.

Works with spotifygithub

91
Spark score
out of 100
Updated 4 months ago
Version 1.0.0
Models

Add to Favorites

Why it matters

Integrate Claude with Spotify to control music playback, search for content, manage queues, and interact with playlists using natural language commands.

Outcomes

What it gets done

01

Control music playback (play, pause, skip)

02

Search for tracks, albums, artists, and playlists

03

Manage the Spotify playback queue

04

Create and update Spotify playlists

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-spotify | bash

Capabilities

Tools your agent gets

play

Start or resume Spotify playback

pause

Pause current Spotify playback

skip

Skip to the next track in Spotify playback

search_tracks

Search for tracks on Spotify by query

search_albums

Search for albums on Spotify by query

search_artists

Search for artists on Spotify by query

search_playlists

Search for playlists on Spotify by query

get_track_info

Get detailed information about a Spotify track

+8 tools

Overview

Spotify MCP Server

Connects Claude to Spotify for playback control, search, queue management, and playlist creation/updates via the spotipy-based API. Marked inactive as of March 2026, with most PRs no longer being merged. Use for conversational Spotify control when a Premium account and developer app are available; some recommendation-related features are unavailable due to Spotify's own API deprecations, and the project itself is unmaintained.

What it does

spotify-mcp connects Claude to Spotify, built on top of the spotipy-dev Python API. It covers starting, pausing, and skipping playback; searching for tracks, albums, artists, or playlists; getting detailed info about a specific track, album, artist, or playlist; managing the Spotify playback queue; and managing, creating, and updating playlists. The project is marked inactive as of March 2026, with most pull requests not being merged - it should be evaluated as a community project without active maintenance rather than one receiving ongoing updates.

Setup requires creating a Spotify developer account and app at developer.spotify.com with a redirect URI of http://127.0.0.1:8080/callback - any port is allowed, but the source notes the URI must use HTTP and an explicit loopback address (IPv4 or IPv6). Using the server also requires Spotify Premium, since the developer API it relies on needs a Premium account.

When to use - and when NOT to

Use this when the goal is controlling Spotify playback, searching the catalog, or managing playlists conversationally through Claude, and a Spotify Premium account with developer API access is available. Because a chunk of Spotify's recommendation-related API features have since been deprecated by Spotify itself, some previously possible functionality is no longer available regardless of how this server is configured - this is an upstream Spotify API limitation, not a bug in the server. Given the project's inactive status, it fits experimentation and personal use more than a dependency a team should rely on for ongoing support.

Capabilities

Running via uvx opens the Spotify authorization redirect on every single tool call, which can get repetitive; running the project locally by cloning the repository avoids this by keeping the authenticated session persistent between calls. Troubleshooting tips include keeping uv updated (version 0.54 or newer recommended), setting execution permissions (chmod -R 755) when running from a local clone, and confirming Spotify Premium is active. The server emits logs to stderr per the MCP spec - on macOS, Claude Desktop writes these to ~/Library/Logs/Claude. It can also be run through the MCP Inspector for interactive debugging via npx @modelcontextprotocol/inspector.

How to install

The quickest path runs directly from GitHub via uvx:

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "git+https://github.com/varunneal/spotify-mcp",
        "spotify-mcp"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
      }
    }
  }
}

Alternatively, cloning the repository and pointing an MCP config at the local directory with uv --directory /path/to/spotify-mcp run spotify-mcp avoids the repeated redirect-URI prompts that the uvx approach triggers on every tool call.

Who it's for

Spotify Premium subscribers who want to control playback, search the catalog, and manage playlists through Claude, and are comfortable relying on a community project that is no longer being actively maintained.

Source README

spotify-mcp MCP server

MCP project to connect Claude with Spotify. Built on top of spotipy-dev's API.

[Notice March 2026]: Inactive project. Most PRs will not be merged.

Features

  • Start, pause, and skip playback
  • Search for tracks/albums/artists/playlists
  • Get info about a track/album/artist/playlist
  • Manage the Spotify queue
  • Manage, create, and update playlists

Demo

Video -- turn on audio https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894

Configuration

Getting Spotify API Keys

Create an account on developer.spotify.com. Navigate to the dashboard.
Create an app with redirect_uri as http://127.0.0.1:8080/callback.
You can choose any port you want but you must use http and an explicit loopback address (IPv4 or IPv6).

See here for more info/troubleshooting.
You may have to restart your MCP environment (e.g. Claude Desktop) once or twice before it works.

Locating MCP Config

For Cursor, Claude Desktop, or any other MCP-enabled client you will have to locate your config.

  • Claude Desktop location on MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

  • Claude Desktop location on Windows: %APPDATA%/Claude/claude_desktop_config.json

Run this project with uvx

Add this snippet to your MCP Config.

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "git+https://github.com/varunneal/spotify-mcp",
        "spotify-mcp"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
      }
    }
  }
}

Run this project locally

Using UVX will open the spotify redirect URI for every tool call. To avoid this, you can run this project locally by cloning this repo:

git clone https://github.com/varunneal/spotify-mcp.git

Add it to your MCP Config like this:

"spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify-mcp",
      "run",
      "spotify-mcp"
    ],
    "env": {
      "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
      "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
      "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
    }
  }

Troubleshooting

Please open an issue if you can't get this MCP working. Here are some tips:

  1. Make sure uv is updated. I recommend version >=0.54.
  2. If cloning locally, enable execution permisisons for the project: chmod -R 755.
  3. Ensure you have Spotify premium (needed for running developer API).

This MCP will emit logs to std err (as specified in the MCP) spec. On Mac the Claude Desktop app should emit these logs
to ~/Library/Logs/Claude.
On other platforms you can find logs here.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify-mcp run spotify-mcp

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

TODO

Unfortunately, a bunch of cool features have now been deprecated
from the Spotify API. Most new features will be relatively minor or for the health of the project:

  • tests.
  • adding API support for managing playlists.
  • adding API support for paginated search results/playlists/albums.

PRs appreciated! Thanks to @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj, @JJGO and others for contributions.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.