MCP Spotify AI Assistant

- "Can you add the top 5 Coldplay songs to my playlist vibes"
- "What are my most listened to songs this past month"
- "Can you shuffle play my top songs"

- Description: Search for tracks, albums, artists, or playlists on Spotify
- Parameters:

- query(string): The search term
- type(string): Type of item to search for (track, album, artist, playlist)
- limit(number, optional): Maximum number of results to return (10-50)

- Description: Get the current user's top artists or tracks based on calculated affinity
- Parameters:

- type(string): The type of entity to return. Valid values: artists or tracks
- time_range(string, optional): Over what time frame the affinities are computed. Long_term ~1 year of data, medium_term is last 6 months, short_term is last 4 weeks
- limit(number, optional): The maximum number of items to return. Default: 20, minimum: 1, maximum: 50

- Description: Get a list of the playlists owned or followed by the current Spotify user
- Parameters:

- limit(number, optional): The maximum number of items to return. Default: 20, minimum: 1, maximum: 50

- Description: Get full details of the items of a playlist owned by a Spotify user
- Parameters:

- playlist_id(string): The Spotify ID of the playlist
- fields(string, optional): A comma-separated list of the fields to return
- limit(number, optional): The maximum number of items to return. Default: 20, minimum: 1, maximum: 50

- Description: Get detailed profile information about the current user
- Parameters: None
- Returns: Users' display name, id, email, and number of followers
- Example:getCurrentUserProfile()

- Description: Get full details of the items of a playlist owned by a Spotify user
- Parameters: None
- Returns: Returns the currently playing item's name and accompanying details
- Example:getCurrentlyPlaying()

- Description: Get full details of the items of a playlist owned by a Spotify user
- Parameters:

- limit(number, optional): The maximum number of items to return. Default: 20, minimum: 1, maximum: 50

- Description: Get the list of objects that make up the user's queue
- Parameters: None
- Returns: The items' names and additional information in the queue
- Example:getUserQueue()

- Description: Start a new playback on the active device
- Parameters:

- device_id(string, optional): The ID of the device this command is targeting
- context_uri(number, optional): Spotify URI of the context to play. Valid contexts are albums, artists, and playlists
- type(number, optional): The type to play. Valid types are track, album, artist, or playlist
- id(number, optional): The Spotify ID of the item to play

- Description: Resume playback on the active device
- Parameters:

- device_id(string, optional): The ID of the device this command is targeting

- Description: Pause playback on the active device
- Parameters:

- device_id(string, optional): The ID of the device this command is targeting

- Description: Add an item to be played next in the playback queue
- Parameters:

- uri(string): The URI of the item to add to the queue. Must be a track or an episode URI
- device_id(string, optional): The ID of the device this command is targeting

- Description: Toggle shuffle on or off for the user's playback
- Parameters:

- state(boolean): True: Shuffle the user's playback. False: Do not shuffle the user's playback
- device_id(string, optional): The ID of the device this command is targeting

- Description: Create a playlist for a Spotify user
- Parameters:

- device_id(string): The user's Spotify user ID
- name(string): The name for your new playlist
- public(boolean, optional): The playlist's public/private status
- description(string, optional): The playlist's description

- Description: Adds one or more items to a user's playlist
- Parameters:

- playlist_id(string): The Spotify ID of the playlist
- uris(string, optional): A comma-separated list of Spotify URIs to add, can be track or episode URIs
- types(boolean, optional): A comma-separated list of types in the same order as ids
- ids(string, optional): A comma-separated list of ids in the same order as types

- Description: Change a playlist's name and public/private state
- Parameters:

- playlist_id(string): The Spotify ID of the playlist
- name(string, optional): The new name for the playlist
- public(boolean, optional): The playlist's new public/private status
- description(string, optional): Value for playlist description

- Node.js v16+
- A Spotify Premium account
- A registered Spotify Developer application

git clone https://github.com/iankan04/MCP-Spotify.git cd mcp-spotify npm install npm run build

Creating a Spotify Developer Application

Create a.env.localfile in the project root (you can copy and modify the provided example):

SPOTIFY_CLIENT_ID='Your client_id' SPOTIFY_CLIENT_SECRET='Your client_secret' SPOTIFY_REDIRECT_URI='Your redirect_uri (i.e. http://127.0.0.1:8000/callback'

The Spotify API uses OAuth 2.0 for authentication. Follow these steps to authenticate your application:
-

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 the Redis database and automatically refreshed when called

To use your MCP server with Claude Desktop, add it to your Claude configuration: