Summary
This connects Claude to the Spotify Web API with full OAuth 2.0 PKCE flow and automatic token refresh. You get search across tracks, artists, albums, and playlists, plus complete playback control: play, pause, skip, volume adjustment, and device switching via Spotify Connect. It also handles playlist management, letting you create, view, and edit playlists programmatically. Setup requires a Spotify Developer app with localhost callback, then one browser authorization that persists tokens locally. Note that playback control and volume require Spotify Premium. Built by Strider Labs, this is the server to reach for when you want Claude to DJ or automate your Spotify workflows without manual API wrangling.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
15 tools
track.statsGet stream count and metadata for a Spotify track. Returns title, artist, total play count, duration in ms, content rating, track number, album info, and artist info.1 params
Get stream count and metadata for a Spotify track. Returns title, artist, total play count, duration in ms, content rating, track number, album info, and artist info.
Parameters* required
track_idstringSpotify ID (22 alphanumeric characters)
album.statsGet album statistics with per-track stream counts. Returns album name, type, release date, label, copyright, cover art, per-track stream counts and durations, and related albums.1 params
Get album statistics with per-track stream counts. Returns album name, type, release date, label, copyright, cover art, per-track stream counts and durations, and related albums.
Parameters* required
album_idstringSpotify ID (22 alphanumeric characters)
artist.statsGet artist statistics including monthly listeners and top tracks. Returns monthly listeners, follower count, world rank, top 5 listener cities, top 10 tracks with stream counts, biography, external links, albums, singles, and verified status.1 params
Get artist statistics including monthly listeners and top tracks. Returns monthly listeners, follower count, world rank, top 5 listener cities, top 10 tracks with stream counts, biography, external links, albums, singles, and verified status.
Parameters* required
artist_idstringSpotify ID (22 alphanumeric characters)
searchSearch Spotify for artists, albums, tracks, and playlists. Returns matching results across all types. Track results include current stream counts.1 params
Search Spotify for artists, albums, tracks, and playlists. Returns matching results across all types. Track results include current stream counts.
Parameters* required
qstringSearch query, e.g. 'Arctic Monkeys'
artist.getGet metadata for one or more artists in a single request. Returns artist names, images, genres, and follower counts.1 params
Get metadata for one or more artists in a single request. Returns artist names, images, genres, and follower counts.
Parameters* required
idsstringComma-separated Spotify IDs (22 alphanumeric characters each)
artist.overviewGet overview data for an artist. Returns detailed artist profile including biography, images, top tracks, discography summary, and related artists.1 params
Get overview data for an artist. Returns detailed artist profile including biography, images, top tracks, discography summary, and related artists.
Parameters* required
artist_idstringSpotify ID (22 alphanumeric characters)
artist.albumsGet all albums in an artist's discography, paginated. Returns album names, IDs, types, release dates, and cover art.3 params
Get all albums in an artist's discography, paginated. Returns album names, IDs, types, release dates, and cover art.
Parameters* required
limitintegerMax results to returndefault: 100
offsetintegerPagination offsetdefault: 0
artist_idstringSpotify ID (22 alphanumeric characters)
artist.singlesGet all singles in an artist's discography, paginated. Returns single names, IDs, release dates, and cover art.3 params
Get all singles in an artist's discography, paginated. Returns single names, IDs, release dates, and cover art.
Parameters* required
limitintegerMax results to returndefault: 100
offsetintegerPagination offsetdefault: 0
artist_idstringSpotify ID (22 alphanumeric characters)
artist.relatedGet artists similar to the given artist. Returns a list of related artists with their names, IDs, images, and follower counts.1 params
Get artists similar to the given artist. Returns a list of related artists with their names, IDs, images, and follower counts.
Parameters* required
artist_idstringSpotify ID (22 alphanumeric characters)
album.getGet metadata for one or more albums in a single request. Returns album names, artists, release dates, track listings, and cover art.1 params
Get metadata for one or more albums in a single request. Returns album names, artists, release dates, track listings, and cover art.
Parameters* required
idsstringComma-separated Spotify IDs (22 alphanumeric characters each)
track.getGet metadata for one or more tracks in a single request. Returns track names, artists, albums, durations, and preview URLs.1 params
Get metadata for one or more tracks in a single request. Returns track names, artists, albums, durations, and preview URLs.
Parameters* required
idsstringComma-separated Spotify IDs (22 alphanumeric characters each)
track.previewGet preview audio URL for a Spotify track. Returns a short preview URL that can be used to listen to a snippet of the track.1 params
Get preview audio URL for a Spotify track. Returns a short preview URL that can be used to listen to a snippet of the track.
Parameters* required
track_idstringSpotify ID (22 alphanumeric characters)
playlist.getGet metadata for a Spotify playlist. Returns playlist name, description, owner, follower count, and cover image.1 params
Get metadata for a Spotify playlist. Returns playlist name, description, owner, follower count, and cover image.
Parameters* required
playlist_idstringSpotify ID (22 alphanumeric characters)
playlist.tracksGet tracks in a Spotify playlist, paginated. Returns track names, artists, albums, durations, and add dates.3 params
Get tracks in a Spotify playlist, paginated. Returns track names, artists, albums, durations, and add dates.
Parameters* required
limitintegerMax results to returndefault: 100
offsetintegerPagination offsetdefault: 0
playlist_idstringSpotify ID (22 alphanumeric characters)
playlist.permissionsGet permissions for a Spotify playlist. Returns whether the playlist is collaborative, public, and who can modify it.1 params
Get permissions for a Spotify playlist. Returns whether the playlist is collaborative, public, and who can modify it.
Parameters* required
playlist_idstringSpotify ID (22 alphanumeric characters)
@striderlabs/mcp-spotify
MCP server for Spotify — let AI agents search music, control playback, and manage playlists via the Spotify Web API.
Built by Strider Labs.
Features
- Search — Find tracks, artists, albums, and playlists
- Playlists — View, create, and edit your playlists
- Playback Control — Play, pause, skip, go back, set volume
- Multi-device — List and switch between Spotify Connect devices
- OAuth 2.0 — Secure authorization with PKCE (no client secret needed)
- Token persistence — Tokens stored locally, auto-refreshed
Setup
1. Create a Spotify App
- Go to the Spotify Developer Dashboard
- Click Create App
- Set Redirect URI to:
http://localhost:8888/callback - Copy your Client ID
2. Install
npx @striderlabs/mcp-spotify
Or install globally:
npm install -g @striderlabs/mcp-spotify
3. Configure Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"spotify": {
"command": "npx",
"args": ["-y", "@striderlabs/mcp-spotify"],
"env": {
"SPOTIFY_CLIENT_ID": "your_client_id_here"
}
}
}
}
4. Authenticate
In Claude, call the auth tool once:
spotify_auth
A browser window will open for you to authorize access. After approving, tokens are saved locally at ~/.striderlabs/spotify/tokens.json and auto-refreshed.
Environment Variables
| Variable | Required | Description |
|---|---|---|
SPOTIFY_CLIENT_ID | Yes | Your Spotify app's Client ID |
Tools
Authentication
| Tool | Description |
|---|---|
spotify_status | Check connection status and logged-in account |
spotify_auth | Authorize via browser (OAuth 2.0 PKCE) |
spotify_logout | Clear stored tokens |
Search
| Tool | Parameters | Description |
|---|---|---|
search_tracks | query, limit? | Search for songs |
search_artists | query, limit? | Search for artists |
search_albums | query, limit? | Search for albums |
search_playlists | query, limit? | Search for playlists |
Playlists
| Tool | Parameters | Description |
|---|---|---|
get_playlists | limit? | Get your playlists |
create_playlist | name, description?, public? | Create a new playlist |
add_to_playlist | playlistId, uris[], position? | Add tracks |
remove_from_playlist | playlistId, uris[] | Remove tracks |
Playback
| Tool | Parameters | Description |
|---|---|---|
get_currently_playing | — | Current track, progress, device |
play | deviceId?, contextUri?, uris?[], offsetPosition?, positionMs? | Start/resume playback |
pause | deviceId? | Pause playback |
next_track | deviceId? | Skip to next track |
previous_track | deviceId? | Go to previous track |
set_volume | volumePercent, deviceId? | Set volume (0–100) |
get_devices | — | List Spotify Connect devices |
transfer_playback | deviceId, play? | Switch playback device |
Example Workflow
1. spotify_status → check if authenticated
2. spotify_auth → open browser to authorize (first time)
3. search_tracks query="Bohemian Rhapsody"
4. get_devices → list available devices
5. play uris=["spotify:track:..."] deviceId="..."
6. get_currently_playing → see what's playing
7. set_volume volumePercent=70
8. next_track → skip to next
9. get_playlists → see your playlists
10. create_playlist name="AI Picks"
11. add_to_playlist playlistId="..." uris=["spotify:track:..."]
Requirements
- Node.js 18+
- Spotify account (Free or Premium)
- Spotify Premium required for: volume control, playback control
Technical Details
- Protocol: Model Context Protocol (MCP) over stdio
- Auth: OAuth 2.0 Authorization Code with PKCE
- API: Spotify Web API v1
- Token storage:
~/.striderlabs/spotify/tokens.json - Browser automation: Playwright (for OAuth browser launch)
License
MIT — Strider Labs
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Registryactive
Package@striderlabs/mcp-spotify
TransportSTDIO
UpdatedMar 15, 2026
