spotify_mcp

What is spotify_mcp?

spotify_mcp is a Spotify integration built using the Model Context Protocol (MCP). It provides tools and resources for interacting with the Spotify API, enabling control over playback and access to user data through the MCP framework.

How to use spotify_mcp?

Clone the repository, set up a virtual environment, install dependencies with uv sync, configure Spotify API credentials in a .env file, and run python src/server.py. For use with Claude as an MCP client, edit claude_desktop_config.json to include the server configuration with your Spotify credentials.

Key features of spotify_mcp

• Play, pause, skip, and control Spotify playback.
• Access and manage user playlists.
• Play user’s liked songs and recently played tracks.
• Control shuffle mode and add songs to queue.
• Retrieve most played songs per week/month/year.

Use cases of spotify_mcp

• Let an AI assistant play a requested song on your Spotify.
• Have the assistant fetch and show your playlists, then start playback from one.
• Automate skipping tracks or turning shuffle on/off during a listening session.
• Get a summary of your recently played or most played tracks via a chat interface.

FAQ from spotify_mcp

What are the prerequisites to run spotify_mcp?

You need a Spotify Developer account with a registered application, a redirect URI (typically http://localhost:8888/callback), and Python with a virtual environment.

How do I authenticate with Spotify?

You must set the environment variables SPOTIPY_CLIENT_ID, SPOTIPY_CLIENT_SECRET, and SPOTIPY_REDIRECT_URI in a .env file or in the MCP client configuration.

What transport does spotify_mcp use?

The README specifies running an MCP server via python src/server.py. Integration with clients like Claude uses standard MCP configuration (stdio transport).

Can I create or modify playlists with spotify_mcp?

Currently, adding songs to a playlist, adding tracks, and creating playlists are listed as “To Implement” and are not yet supported.

What data does spotify_mcp access?

It accesses playback state (current song, queue), user playlists, liked songs, recently played tracks, and listening history (most played songs by period).