Summary
Connects Claude to Spotify's Web API using client_credentials OAuth, exposing four core lookup tools: get_track, get_artist, get_album, and get_artist_top_tracks. You get back structured metadata like popularity scores, genres, follower counts, preview URLs, and album tracklists. Useful when you need to fetch Spotify catalog data on demand, check artist stats, or grab track details by ID. Part of the Pipeworx gateway ecosystem, so you can either connect to just Spotify or hook into their full 250+ data source gateway. Supports both direct tool calls and natural language queries through ask_pipeworx. Ships as a streamable HTTP transport, so setup is just dropping a URL into your MCP client config.
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)
mcp-spotify
Spotify MCP — Web API via client_credentials OAuth
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|---|
get_track | Single track by Spotify ID. Returns artists, album, popularity, preview URL, duration. |
get_artist | Artist record: name, genres, popularity, followers, images. |
get_album | Album record with tracklist. |
get_artist_top_tracks | Top tracks for an artist in a market (Spotify recommendation). |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"spotify": {
"url": "https://gateway.pipeworx.io/spotify/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Spotify data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
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 →
