Integrations
Allows control of Spotify playback including play, pause, skip functions, search for tracks/albums/artists/playlists, get information about Spotify content, and manage the Spotify queue
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
- Manage, create, and update playlists
Demo
Make sure to turn on audio
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.
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
Add this tool as a mcp server.
Claude Desktop on MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Claude Desktop on Windows: %APPDATA%/Claude/claude_desktop_config.json
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:
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, and others for contributions.
Deployment
(todo)
Building and Publishing
To prepare the package for distribution:
- Sync dependencies and update lockfile:
- Build package distributions:
This will create source and wheel distributions in the dist/
directory.
- Publish to PyPI:
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:
--token
orUV_PUBLISH_TOKEN
- Or username/password:
--username
/UV_PUBLISH_USERNAME
and--password
/UV_PUBLISH_PASSWORD
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
A server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityConnects Claude with Spotify, allowing users to control playback, search for content, get music information, and manage the Spotify queue.Last updated -81Python
- -securityFlicense-qualityConnects Claude with Spotify, enabling playback control, search functionality, and queue management through Spotify's API.Last updated -Python
- -securityFlicense-qualityConnects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.Last updated -Python
- AsecurityFlicenseAqualityConnects Claude with Spotify, allowing users to control playback, search for music, get track/artist information, and manage the queue via the Spotify API.Last updated -5Python