# Spotify MCP Server
A simple MCP server to control Spotify playback and manage your liked songs via LLM's.
## Features
- Play and pause Spotify playback
- Get info about the current track
- Add the current track to your Liked Songs
## Setup
1. **Clone the repository:**
```sh
git clone https://github.com/yourusername/spotify-mcp-server.git
cd spotify-mcp-server
```
2. **Create and activate a virtual environment:**
```sh
python3 -m venv .venv
source .venv/bin/activate
```
3. **Install dependencies:**
```sh
pip install uv
pip install -r requirements.txt
```
4. **Create a `.env` file:**
```
SPOTIPY_CLIENT_ID=your_spotify_client_id
SPOTIPY_CLIENT_SECRET=your_spotify_client_secret
SPOTIPY_REDIRECT_URI=http://localhost:8888/callback
```
5. **Run the server:**
```sh
python main.py
```
## Integration with Claude Desktop (MCP Server)
To use this server as an MCP server with Claude, add the following entry to your Claude config file (usually located at `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"mcpServers": {
"spotify-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PROJECT/spotify-mcp-server",
"run",
"main.py"
]
}
}
}
```
- Replace `/ABSOLUTE/PATH/TO/PROJECT/spotify-mcp-server` with the actual path to your project
- If command `uv` is not recognized, give the absolute path for `uv` executable (can be found with `which uv` on MacOS)
- Make sure your environment variables are set either in the config or via a `.env` file.
- Restart Claude after editing the config file.
## Notes
- You need to register your app at the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/) to get your client ID and secret.
## Example Session
Below is an example session using Claude with the Spotify MCP server:
**Sample interaction:**
```
User: Play the current track using Spotify MCP server
Claude: Playback started successfully
User: What song is playing?
Claude: Currently playing: Shape of You by Ed Sheeran
User: Like this song
Claude: Added 'Shape of You' to your Liked Songs.
```
