spotify-mcp

spotify-mcp

1

The Spotify MCP Server allows users to manage Spotify playback through the Spotify API using the Model Context Protocol framework. It supports essential playback functions like play, pause, and track navigation, and requires Python and Spotify account setup.

Spotify MCP Server

The Spotify MCP Server is designed to interact with the Spotify API, providing control over Spotify playback such as playing, pausing, skipping tracks, and shuffling playlists. Built using the mcp framework and spotipy library, it requires Python 3.12 and a Spotify Developer account to set up. Key features include:

  • Control playback with play, pause, and skip functions.
  • Shuffle and repeat playlists.
  • Play specific albums or tracks by name.

Installation

  1. Clone the repository and navigate into it.
  2. Create and activate a virtual environment.
  3. Install dependencies using uv from the pyproject.toml file.
  4. Create a .env file with Spotify credentials.

Usage

  • Start the MCP server and use tools to control Spotify playback.
  • Integrate MCP tools into your MCP client, such as Claude.

Troubleshooting

  • Confirm your credentials in the .env file are correct if facing authentication issues.
  • Ensure the server configuration is set correctly for proper startup.

Contributing

Contributions through issues or pull requests are welcome.