Custom Spotify MCP

This project is a custom MCP server that integrates Spotify to generate playlists based on user emotions.

Setup Instructions

Follow these steps to set up and run the project:

1. Install Dependencies

Install uv using Homebrew:

brew install uv

2. Clone the Repository

Clone this repository to a directory of your choice:

git clone https://github.com/dldnlee/custom_spotify_mcp.git custom_spotify_mcp
cd custom_spotify_mcp

3. Initialize the Environment

Open a terminal in the cloned directory and run:

uv init

4. Create Environment Variables

You can get the required tokens from Spotify for Developers

SPOTIFY_CLIENT_ID=your-spotify-client-id
SPOTIFY_CLIENT_SECRET=your-spotify-client-secret
SPOTIFY_REDIRECT_URI=http://127.0.0.1:8888/callback (Needs to be identical with the URI saved in Spotify Developer's App Settings)

Run

python3 util/spotify_auth.py

or

python util/spotify_auth.py

To generate the access tokens. Needs to be created every hour

4. Install MCP Server to Claude

mcp install server.py

TroubleShooting

If uv init doesn't work, manually add the required libraries:

uv add "mcp[cli]"
uv add "requests"

Notes

Ensure you have created a Spotify Developer App and configured:

• Client ID
• Client Secret
• Redirect URI
• These credentials should be securely added in spotify_auth.py.

Useful Links

Spotify for Developers

MCP Python SDK