MCP-for-spotify

Alexd134/MCP-for-spotify

3.2

If you are the rightful owner of MCP-for-spotify and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Spotify MCP project provides a protocol server that allows an LLM to interact with Spotify's Web API through various tools.

Tools
6
Resources
0
Prompts
0

Spotify MCP

This project exposes a small set of Spotify-related tools over the MCP (Model-Controller Protocol) server so an LLM (for example Claude) can call them as tools. It wraps the Spotify Web API (via spotipy) and exposes tools for Playback, Search, Queue, Playlist management, and Top Items.

What this project does

  • Provides an MCP server (src/spotify_mcp/server.py) that registers multiple tools:
    • Playback: get, start, pause, skip, previous, set volume, seek.
    • Search: search tracks/albums/artists/playlists.
    • Queue: view or add to the playback queue.
    • GetInfo: fetch detailed info for a Spotify URI (track/album/artist/playlist).
    • Playlist: list, get tracks, add tracks, remove tracks, change playlist details.
    • TopItems: fetch user's top tracks or artists over time ranges.

Requirements

  • Python 3.12+
  • Dependencies listed in pyproject.toml (install with your preferred tool)
  • A Spotify developer app (Client ID, Client Secret, Redirect URI)

Linking with Claude (or any MCP-capable LLM)

Add this snippet to your MCP Config.

"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://127.0.0.1:8080/callback"
    }
}