Return the installed version of the mcp-spotify server.

Search for tracks on Spotify.

Supports Spotify query syntax for filtering:

• genre: "genre:rock"

• year: "year:2020" or "year:2018-2022"

• artist: "artist:radiohead"

• combined: "genre:indie year:2020-2024"

Returns track names, artists, albums, and IDs.

Search for artists on Spotify.

Supports the same query syntax as search_tracks. Returns artist names, genres, and IDs. Useful for finding an artist ID to explore their catalog.

Search for albums on Spotify.

Returns album names, artists, release dates, and IDs. Use get_album_tracks to list the tracks on a found album.

Get all tracks on a Spotify album.

Accepts a Spotify album ID or full URI. Returns track names, artists, and IDs. Useful for adding an entire album to a playlist.

Get the current user's saved (liked) tracks.

Returns tracks from the user's library, sorted by most recently saved. Supports pagination via limit (max 50) and offset. A rich signal for playlist building since liked songs reflect explicit user preference.

Create a new Spotify playlist for the current user.

Returns the playlist ID and URI for use with other playlist tools.

Add tracks to a Spotify playlist.

Accepts a list of track IDs or URIs (max 100 per call). Tracks are appended to the end of the playlist.

Remove tracks from a Spotify playlist.

Removes all occurrences of each track. Accepts track IDs or URIs (max 100 per call).

Replace all tracks in a playlist with the given list, in order.

This is useful for reordering a playlist. First get the current tracks with get_playlist_tracks, reorder the IDs as desired, then pass the full ordered list here. The playlist will contain exactly these tracks in exactly this order.

Accepts track IDs or URIs. No limit on total tracks (batched internally).

Follow (save) a Spotify playlist to your library.

Accepts a playlist ID or URI. Use this to save playlists found via search or shared by others.

Unfollow (remove) a Spotify playlist from your library.

For playlists you own, this is the only way to 'delete' them -- Spotify has no true delete. The playlist will no longer appear in your library or profile.

Get the tracks in a Spotify playlist.

Supports pagination via limit (max 100) and offset. Returns track names, artists, IDs, and total count.

List the current user's Spotify playlists.

Returns playlist names, IDs, track counts, and ownership info.

Get the current user's top tracks on Spotify.

time_range options:

• "short_term": approximately last 4 weeks

• "medium_term": approximately last 6 months (default)

• "long_term": all time

Useful as a seed for building personalized playlists.

Get the current user's top artists on Spotify.

time_range options:

• "short_term": approximately last 4 weeks

• "medium_term": approximately last 6 months (default)

• "long_term": all time

Useful for discovering related artists when building playlists.

Start playing a track on Spotify.

Requires an active Spotify device (open Spotify on any device first). Accepts a Spotify track URI (spotify:track:) or bare track ID.

Pause the current Spotify playback.

Add a track to the end of the playback queue.

Requires an active Spotify device. Accepts a track URI or bare track ID.

Get information about the currently playing track on Spotify.

Returns track name, artist, album, progress, and playback state. Returns {"is_playing": False} if nothing is currently playing.