Spotify

This MCP server lets Claude interact with Spotify, enabling you to start, pause, skip, search, get track/album/artist/playlist info, and manage the queue from your Claude workflows. It connects to Spotify using your API keys and runs locally through the MCP runtime so you can issue musical actions directly from conversations.

How to use

You interact with the Spotify MCP server through your MCP client by issuing high‑level media commands. Use the available actions to control playback, search for music, retrieve information about tracks or playlists, and manage the queue. The server runs locally and communicates with Spotify using your configured API credentials.

How to install

Prerequisites you need before you start:

• A running MCP runtime environment (uv)
• Python, Node, or the runtime stack required by your MCP toolchain (as applicable)
• Spotify Developer account and API keys

Set up and run the Spotify MCP server with the following steps. Adjust paths and keys to your environment.

# 1) Ensure the MCP runtime is available
# 2) Prepare the Spotify MCP runtime directory and run command
# 3) Start the server using the MCP command shown in the config

# Example run command (adjust to your environment):
uv --directory /path/to/spotify_mcp run spotify-mcp

Additional configuration and notes

{
  "spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify_mcp",
      "run",
      "spotify-mcp"
    ],
    "env": {
      "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
      "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
      "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
    }
  }
}

Troubleshooting

If you encounter issues, try the following tips to resolve common problems. Ensure the MCP runtime tool uv is up to date, verify your permissions for the MCP directory, and confirm you have a valid Spotify Premium account for API access.

# Quick checks
uv version
chmod -R 755 /path/to/spotify_mcp
# Ensure Spotify credentials are correctly set in the environment
export SPOTIFY_CLIENT_ID=YOUR_CLIENT_ID
export SPOTIFY_CLIENT_SECRET=YOUR_CLIENT_SECRET
export SPOTIFY_REDIRECT_URI=http://localhost:8888

Tools and capabilities

This server exposes the following capabilities for interactive control of Spotify from Claude: start playback, pause playback, skip to next track, search for tracks/albums/artists/playlists, get detailed info about tracks/albums/artists/playlists, and manage the playback queue.

Available tools

start_playback

Start playback on the active Spotify device.

pause_playback

Pause the currently playing track.

skip_track

Skip to the next track in the queue.

search

Search for tracks, albums, artists, or playlists.

get_info

Retrieve information about a track, album, artist, or playlist.

manage_queue

Add to or clear the Spotify playback queue and view queue contents.