Enables creation of Spotify playlists based on text descriptions, with OAuth authentication handling for accessing Spotify's API.
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)
Related MCP server: Spotify MCP
Setup
Clone this repository:
git clone https://github.com/yourusername/spotify-mcp.git cd spotify-mcpInstall the required dependencies:
pip install -r requirements.txtSet up your Spotify Developer credentials:
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 URIsSave 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:
Now you can use the Spotify MCP commands in Cursor to create and manage playlists directly from your editor!