Spotify

community

other

This MCP allows an LLM to play and use Spotify.

Source Code

spotify-mcp MCP server

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

Features

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

Demo

Make sure to turn on audio

<details> <summary> Video </summary> https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894 </summary> </details>

Configuration

Getting Spotify API Keys

Create an account on developer.spotify.com. Navigate to the dashboard. Create an app with redirect_uri as http://localhost:8888. (You can choose any port you want but you must use http and localhost). I set "APIs used" to "Web Playback SDK".

Run this project locally

This project is not yet set up for ephemeral environments (e.g.

uvx

usage). Run this project locally by cloning this repo

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

Add this tool as a mcp server.

On MacOS:

~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%/Claude/claude_desktop_config.json

"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://localhost:8888"
    }
  }

Troubleshooting

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

Make sure
```
uv
```
is updated. I recommend version
```
>=0.54
```
.
Make sure claude has execution permisisons for the project:
```
chmod -R 755
```
.
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!

Deployment

(todo)

Building and Publishing

To prepare the package for distribution:

Sync dependencies and update lockfile:

uv sync

Build package distributions:

uv build

This will create source and wheel distributions in the

dist/

directory.

Publish to PyPI:

uv publish

Note: You'll need to set PyPI credentials via environment variables or command flags:

Token:
```
--token
```
or
```
UV_PUBLISH_TOKEN
```

Or username/password:

--username

UV_PUBLISH_USERNAME

and

--password

UV_PUBLISH_PASSWORD

Related Servers

Everything

reference

Reference / test server with prompts, resources, and tools

View Details

Memory

reference

Knowledge graph-based persistent memory system

View Details

Puppeteer

reference

Browser automation and web scraping

View Details

Sentry

reference

Retrieving and analyzing issues from Sentry.io

View Details

Sequential Thinking

reference

Dynamic and reflective problem-solving through thought sequences

View Details