Spotify

This MCP server bridges AI assistants with Spotify’s Web API, giving you a structured, type-safe interface to search, play, manage playlists, follow artists, access your profile, and retrieve lyrics. It’s designed for easy extension, robust validation, and smooth integration with MCP clients so you can control Spotify via natural language or scripted commands.

How to use

You connect an MCP client to this server to perform music discovery, playback control, and library management through Spotify. Use natural language commands or scripted tool calls in your MCP client to access albums, artists, tracks, playlists, playback controls, user data, and search capabilities. The server exposes a comprehensive set of tools that you can invoke from your client to achieve common tasks such as playing a song, creating a playlist, adding tracks to your library, or retrieving lyrics.

How to install

Prerequisites: make sure Node.js and npm are installed on your machine. You will also need access to a Spotify account to authorize the Web API usage.

Step-by-step installation and startup flow:

# 1. Clone the project repository (use your own URL)
git clone <repository-url>
cd Spotify-OAuth-MCP-server

# 2. Install dependencies
npm install

# 3. Build the TypeScript code
npm run build

# 4. Start the MCP server
npm start

# Optional: development with auto-reload
npm run dev

Claude Desktop integration and configuration

To use this MCP server with Claude Desktop, add it to your MCP configuration. The server can be run locally and exposed to Claude Desktop through a stdio configuration.

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/path/to/your/project/src/mcp/server.js"]
    }
  }
}

Available tools

get_album

Retrieve detailed information about a specific album.

get_album_tracks

Fetch tracks contained in a given album.

get_new_releases

Discover newly released albums.

search_albums

Search for albums using keywords.

get_artist

Get detailed information about an artist.

get_artist_albums

Retrieve an artist's albums.

get_artist_top_tracks

Obtain an artist's most popular tracks.

search_artists

Search for artists by keywords.

get_followed_artists

Get the user's followed artists.

get_top_artists

Get the user's top artists.

get_track

Get detailed information about a track.

search_tracks

Search for tracks by keywords.

get_liked_tracks

Retrieve the user's saved or liked tracks.

save_tracks

Add tracks to the user's library.

remove_tracks

Remove tracks from the user's library.

get_top_tracks

Get the user's top tracks.

get_recently_played

Retrieve recently played tracks.

get_track_lyrics

Get plain text lyrics for a track.

get_playlist

Retrieve playlist details.

get_user_playlists

Fetch the user's playlists.

get_playlist_tracks

Get tracks from a playlist.

create_playlist

Create a new playlist.

add_to_playlist

Add tracks to a playlist.

remove_from_playlist

Remove tracks from a playlist.

search_playlists

Search for playlists by keywords.

get_categories

Retrieve browse categories.

save_playlist

Follow or save a user-created playlist.

unsave_playlist

Unfollow or unsave a playlist.

get_currently_playing

Get current playback information.

start_playback

Start playback of music.

resume_player

Resume paused playback.

pause_player

Pause current playback.

skip_to_next

Skip to the next track.

skip_to_previous

Skip to the previous track.

set_volume

Adjust the playback volume.

add_to_queue

Add a track to the playback queue.

get_devices

List available playback devices.

transfer_playback

Transfer playback to another device.

get_user_profile

Get the current user’s profile information.

search_music

Search for tracks, artists, albums, or playlists.

search_and_play_music

Search content and start playback immediately.