The Spotify MCP Server is a lightweight server that enables AI assistants to control Spotify playback and manage playlists. It provides these capabilities:
Search Spotify: Search for tracks, albums, artists, or playlists
Playback Control: Play, pause, resume, skip to next/previous track
Playback Information: Get details about currently playing and recently played tracks
Playlist Management: List user playlists, view playlist tracks, create new playlists, and add tracks to existing playlists
Queue Management: Add tracks, albums, artists, or playlists to the playback queue
Device Integration: Specify device IDs for playback control
Enables control of Spotify playback and playlist management, including searching for tracks/albums/artists, playing music, creating playlists, adding tracks to playlists, and controlling playback (pause, skip, etc.).
A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.
Example Interactions
"Play Elvis's first song"
"Create a Taylor Swift / Slipknot fusion playlist"
"Copy all the techno tracks from my workout playlist to my work playlist"
Tools
Read Operations
searchSpotify
Description: Search for tracks, albums, artists, or playlists on Spotify
Parameters:
query
(string): The search termtype
(string): Type of item to search for (track, album, artist, playlist)limit
(number, optional): Maximum number of results to return (10-50)
Returns: List of matching items with their IDs, names, and additional details
Example:
searchSpotify("bohemian rhapsody", "track", 20)
getNowPlaying
Description: Get information about the currently playing track on Spotify
Parameters: None
Returns: Object containing track name, artist, album, playback progress, duration, and playback state
Example:
getNowPlaying()
getMyPlaylists
Description: Get a list of the current user's playlists on Spotify
Parameters:
limit
(number, optional): Maximum number of playlists to return (default: 20)offset
(number, optional): Index of the first playlist to return (default: 0)
Returns: Array of playlists with their IDs, names, track counts, and public status
Example:
getMyPlaylists(10, 0)
getPlaylistTracks
Description: Get a list of tracks in a specific Spotify playlist
Parameters:
playlistId
(string): The Spotify ID of the playlistlimit
(number, optional): Maximum number of tracks to return (default: 100)offset
(number, optional): Index of the first track to return (default: 0)
Returns: Array of tracks with their IDs, names, artists, album, duration, and added date
Example:
getPlaylistTracks("37i9dQZEVXcJZyENOWUFo7")
getRecentlyPlayed
Description: Retrieves a list of recently played tracks from Spotify.
Parameters:
limit
(number, optional): A number specifying the maximum number of tracks to return.
Returns: If tracks are found it returns a formatted list of recently played tracks else a message stating: "You don't have any recently played tracks on Spotify".
Example:
getRecentlyPlayed({ limit: 10 })
getRecentlyPlayed
Description: Retrieves a list of recently played tracks from Spotify.
Parameters:
limit
(number, optional): A number specifying the maximum number of tracks to return.
Returns: If tracks are found it returns a formatted list of recently played tracks else a message stating: "You don't have any recently played tracks on Spotify".
Example:
getRecentlyPlayed({ limit: 10 })
Play / Create Operations
playMusic
Description: Start playing a track, album, artist, or playlist on Spotify
Parameters:
uri
(string, optional): Spotify URI of the item to play (overrides type and id)type
(string, optional): Type of item to play (track, album, artist, playlist)id
(string, optional): Spotify ID of the item to playdeviceId
(string, optional): ID of the device to play on
Returns: Success status
Example:
playMusic({ uri: "spotify:track:6rqhFgbbKwnb9MLmUQDhG6" })
Alternative:
playMusic({ type: "track", id: "6rqhFgbbKwnb9MLmUQDhG6" })
pausePlayback
Description: Pause the currently playing track on Spotify
Parameters:
deviceId
(string, optional): ID of the device to pause
Returns: Success status
Example:
pausePlayback()
skipToNext
Description: Skip to the next track in the current playback queue
Parameters:
deviceId
(string, optional): ID of the device
Returns: Success status
Example:
skipToNext()
skipToPrevious
Description: Skip to the previous track in the current playback queue
Parameters:
deviceId
(string, optional): ID of the device
Returns: Success status
Example:
skipToPrevious()
createPlaylist
Description: Create a new playlist on Spotify
Parameters:
name
(string): Name for the new playlistdescription
(string, optional): Description for the playlistpublic
(boolean, optional): Whether the playlist should be public (default: false)
Returns: Object with the new playlist's ID and URL
Example:
createPlaylist({ name: "Workout Mix", description: "Songs to get pumped up", public: false })
addTracksToPlaylist
Description: Add tracks to an existing Spotify playlist
Parameters:
playlistId
(string): ID of the playlisttrackUris
(array): Array of track URIs or IDs to addposition
(number, optional): Position to insert tracks
Returns: Success status and snapshot ID
Example:
addTracksToPlaylist({ playlistId: "3cEYpjA9oz9GiPac4AsH4n", trackUris: ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh"] })
addToQueue
Description: Adds a track, album, artist or playlist to the current playback queue
Parameters:
uri
(string, optional): Spotify URI of the item to add to queue (overrides type and id)type
(string, optional): Type of item to queue (track, album, artist, playlist)id
(string, optional): Spotify ID of the item to queuedeviceId
(string, optional): ID of the device to queue on
Returns: Success status
Example:
addToQueue({ uri: "spotify:track:6rqhFgbbKwnb9MLmUQDhG6" })
Alternative:
addToQueue({ type: "track", id: "6rqhFgbbKwnb9MLmUQDhG6" })
Setup
Prerequisites
Node.js v16+
A Spotify Premium account
A registered Spotify Developer application
Installation
Creating a Spotify Developer Application
Go to the Spotify Developer Dashboard
Log in with your Spotify account
Click the "Create an App" button
Fill in the app name and description
Accept the Terms of Service and click "Create"
In your new app's dashboard, you'll see your Client ID
Click "Show Client Secret" to reveal your Client Secret
Click "Edit Settings" and add a Redirect URI (e.g.,
http://localhost:8888/callback
)Save your changes
Spotify API Configuration
Create a spotify-config.json
file in the project root (you can copy and modify the provided example):
Then edit the file with your credentials:
Authentication Process
The Spotify API uses OAuth 2.0 for authentication. Follow these steps to authenticate your application:
Run the authentication script:
The script will generate an authorization URL. Open this URL in your web browser.
You'll be prompted to log in to Spotify and authorize your application.
After authorization, Spotify will redirect you to your specified redirect URI with a code parameter in the URL.
The authentication script will automatically exchange this code for access and refresh tokens.
These tokens will be saved to your
spotify-config.json
file, which will now look something like:
The server will automatically refresh the access token when needed, using the refresh token.
Integrating with Claude Desktop, Cursor, and VsCode Via Cline model extension
To use your MCP server with Claude Desktop, add it to your Claude configuration:
For Cursor, go to the MCP tab in Cursor Settings
(command + shift + J). Add a server with this command:
To set up your MCP correctly with Cline ensure you have the following file configuration set cline_mcp_settings.json
:
You can add additional tools to the auto approval array to run the tools without intervention.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A lightweight Model Context Protocol server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables controlling Spotify playback through natural language commands in MCP clients like Cursor or Claude for Desktop.Last updated -2
- AsecurityAlicenseAqualityA Model Context Protocol server that allows AI assistants like Claude and Cursor to create music and control Sonic Pi programmatically through OSC messages.Last updated -238MIT License
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact with Spotify, allowing them to search for tracks, control playback, and manage playlists.Last updated -1
- AsecurityFlicenseAqualityA Model Context Protocol server that enables Claude to interact with Spotify, allowing users to search for songs, create playlists, add tracks, and get recommendations using their Spotify account.Last updated -74