mcp-spotify

Describe the vibe. Get the playlist! ✨

This is a Python-based MCP (Model Context Protocol) server that allows AI agents (like Claude, Cursor) to create, manage, and populate Spotify playlists using the Spotify Web API.

🚀 Features

• You can create new private playlists
• Can search songs by name
• Add tracks to playlists
• Fully compatible with MCP client tool systems like Claude Desktop, Cursor, or your custom client

🔧 Setup Instructions

1. Clone the Repository

git clone https://github.com/HimanshuSharmaKUL/mcp-spotify.git
cd mcp-spotify

2. Create .env file

Create a .env file in the repo and collect the following credentials for Spotify API integration

CLIENT_ID=your_spotify_client_id
CLIENT_SECRET=your_spotify_client_secret
REDIRECT_URI=http://localhost:8888/callback

3. Install uv if not installed

From the official uv installation guide For windows use

pipx install uv

4. Install dependencies

uv pip install -r requirements.txt

5a. Run it with mcp inspector

npx @modelcontextprotocol/inspector uv run mcpspotify_server.py

5b. Can also integrate it with Claude Desktop

Add the following in your the config.json of your Claude Desktop. Add it under the mcpServers

"mcp-spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "C:\\Path\\To\\mcp-spotify-playlist",
      "run",
      "mcpspotify_server.py"
    ]
  }