Spotify Model Context Protocol (MCP)
A Spotify MCP for creating playlists based on a description.
Prerequisites
- Python 3.6 or higher
- Spotify Developer credentials (Client ID and Client Secret)
Setup
-
Clone this repository:
git clone https://github.com/yourusername/spotify-mcp.git cd spotify-mcp -
Install the required dependencies:
pip install -r requirements.txt -
Set up your Spotify Developer credentials:
- Go to Spotify Developer Dashboard
- Create a new application
- Set up your environment variables:
echo SPOTIFY_CLIENT_ID='your_client_id' >> .env echo SPOTIFY_CLIENT_SECRET='your_client_secret' >> .env
Usage
Starting the Authentication Server
-
Set up your redirect URI in the Spotify Developer Dashboard:
- Go to your app in the Spotify Developer Dashboard
- Click "Edit Settings"
- Add
http://localhost:5000/callbackto the Redirect URIs - Save the changes
-
Start the authentication server:
python main.pyThis will start a local server on port 5000 that handles Spotify OAuth authentication.
-
Visit
http://localhost:5000in your browser to authenticate with Spotify. After successful authentication, your access token will be saved for use with the MCP.
Integrating with Cursor
- Open Cursor and go to Settings
- Navigate to the "Model Context Protocols" section
- Click "Add MCP"
- Enter the following details in your mcp.json, replacing PATH-TO-BASE-DIR:
{
"mcpServers": {
"spotify": {
"command": "uv",
"args": [
"--directory",
"PATH-TO-BASE-DIR/spotify-mcp",
"run",
"spotify.py"
]
}
}
}
Now you can use the Spotify MCP commands in Cursor to create and manage playlists directly from your editor!