This project provides an MCP (Model Context Protocol) server to connect Large Language Models (LLMs) like Claude with Spotify functionality. It enables users to control music playback, search for content, and manage playlists directly through their LLM interface, offering a seamless integration for music lovers.

How It Works

The MCP server acts as a bridge, translating LLM commands into Spotify API requests. It leverages the spotipy-dev library to interact with Spotify's Web API, handling authentication and executing actions such as playback control, content searching, and playlist management. This approach allows LLMs to access and control Spotify without needing direct API integration within the LLM itself.

Quick Start & Requirements

• Install/Run: Clone the repository and run using uv run spotify-mcp.
• Prerequisites: Spotify Premium account, Spotify Developer account with an app created (redirect URI http://127.0.0.1:8080/callback), uv package manager (version >=0.54 recommended).
• Setup: Requires configuration of Spotify API credentials (Client ID, Client Secret) in the claude_desktop_config.json file.
• Docs: Spotify Developer Dashboard

Highlighted Details

• Control playback (start, pause, skip).
• Search for tracks, albums, artists, and playlists.
• Retrieve detailed information about music content.
• Manage the Spotify playback queue.
• Manage, create, and update playlists.

Maintenance & Community

Contributions acknowledged from @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj. A TODO list includes adding playlist management API support, paginated search results, and tests. Users are encouraged to open issues for troubleshooting.

Licensing & Compatibility

The repository does not explicitly state a license in the provided README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project is not yet set up for ephemeral environments. Some Spotify API features have been deprecated, potentially limiting future functionality. The README mentions that new features will be minor or for project health, with a specific focus on adding tests and improving playlist management.