Spotify
Search, play and manage Spotify playlists and your library from an MCP client
- Pricing
- Free
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.9.2
- Listing updated
- today
Similar MCP servers
About Spotify
Spotify is a free MCP server for events and entertainment. It runs locally on your machine and is started by your AI client.
This local Python server drives your own Spotify account through 48 tools, six resources and five prompts. It is a maintained fork of an earlier Spotify MCP project, and a TypeScript edition exists for hosted use.
Setup needs Python 3.12+, uv and your own Spotify developer app, with its client ID, secret and a 127.0.0.1:8888 redirect URI. Playback needs Spotify Premium and an available Connect device. First use opens a browser for authorisation, and the token is cached locally.
The design leans on large libraries: playlist reads return up to 1,000 tracks per call with a continuation offset, library writes are batched in groups of 40, and removals ask for confirmation where the client supports it. New playlists default to private. The README warns that batch writes are not atomic and that Spotify's developer-mode quotas limit how many users an app can serve.
Install
Run in a terminal
claude mcp add spotify-mcp --env SPOTIFY_CLIENT_ID='<SPOTIFY_CLIENT_ID>' --env SPOTIFY_CLIENT_SECRET='<SPOTIFY_CLIENT_SECRET>' --env SPOTIFY_REDIRECT_URI='<SPOTIFY_REDIRECT_URI>' -- uvx spotify-mcp-jamiewAdd to claude_desktop_config.json
{
"mcpServers": {
"spotify-mcp": {
"command": "uvx",
"args": [
"spotify-mcp-jamiew"
],
"env": {
"SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
"SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
"SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"spotify-mcp": {
"command": "uvx",
"args": [
"spotify-mcp-jamiew"
],
"env": {
"SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
"SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
"SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"spotify-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"spotify-mcp-jamiew"
],
"env": {
"SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
"SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
"SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"spotify-mcp": {
"command": "uvx",
"args": [
"spotify-mcp-jamiew"
],
"env": {
"SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
"SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
"SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"spotify-mcp": {
"command": "uvx",
"args": [
"spotify-mcp-jamiew"
],
"env": {
"SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
"SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
"SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SPOTIFY_CLIENT_IDSpotify app Client ID from developer.spotify.comRequiredSPOTIFY_CLIENT_SECRETSpotify app Client Secret from developer.spotify.comRequiredSPOTIFY_REDIRECT_URIOAuth redirect URI registered in your Spotify appRequired
Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- get_me
- Read your profile.
- search_music
- Search tracks, albums, artists or playlists with filters.
- control_playback
- Play, pause, skip, seek, volume, shuffle and repeat.
- list_devices
- List Spotify Connect devices.
- transfer_playback
- Move playback to another device.
- get_queue
- Read now playing and upcoming items.
- add_to_queue
- Queue a track or episode.
- list_playlists
- List your playlists.
- get_playlist_tracks
- Read up to 1000 playlist tracks per call.
- create_playlist
- Create a private playlist.
- add_tracks_to_playlist
- Add up to 100 tracks or episodes.
- remove_tracks_from_playlist
- Remove tracks with confirmation where supported.
- reorder_playlist
- Move a block of tracks.
- get_saved_tracks
- Read Liked Songs.
- save_tracks
- Like tracks.
- get_top_items
- Read top artists or tracks over a time range.
- get_recently_played
- Read recently played tracks with timestamps.
What it does
- 48 tools
- Covers search, playback, queue, playlists and library.
- Large playlist reads
- Pages up to 1,000 tracks per call.
- Safe edits
- Confirmations and snapshot guards for removal and reordering.
- Library management
- Saves tracks, albums, shows, episodes and audiobooks.
- Listening history
- Reads top items and recently played.
Good for
- Build a playlist from a text description
- Control playback on a Connect device
- Clean up Liked Songs in bulk
- Review top artists over a time range
Pricing
Free
Free; Spotify Premium needed for playback
Spotify FAQ
What do I need?
Python 3.12+, uv, a Spotify developer app and Premium for playback.
Are new playlists public?
No, they default to private.
Are bulk writes atomic?
No; earlier changes may remain after an error.
Where does the token live?
Cached locally after browser authorisation.
Is Spotify free?
Yes. Spotify is free to use.
How do I add Spotify to Claude Code?
Run this command in your terminal: claude mcp add spotify-mcp --env SPOTIFY_CLIENT_ID='<SPOTIFY_CLIENT_ID>' --env SPOTIFY_CLIENT_SECRET='<SPOTIFY_CLIENT_SECRET>' --env SPOTIFY_REDIRECT_URI='<SPOTIFY_REDIRECT_URI>' -- uvx spotify-mcp-jamiew
What are the best alternatives to Spotify?
The closest alternatives to Spotify are Dostuff, Skiddle, Madrid Events, Nyc Parks and Edmtrain.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
