Spotify

by boristopalov

1.9k downloads

Not rated

GitHub

About

Integrates with Spotify's API to control music playback, search for content, get detailed information, and manage queues directly within conversations.

Details

Author: boristopalov
Repository: boristopalov/spotify-mcp
Downloads: 1,906
Categories: AI, Design, Developer Tools, Search, Infrastructure, Knowledge Base

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Spotify

Command (node, npx, python, etc.) uv
Arguments
- Argument 1 --directory
- Argument 2 /path/to/spotify_mcp
- Argument 3 run
- Argument 4 spotify-mcp
Environment
- SPOTIFY_CLIENT_ID YOUR_CLIENT_ID
- SPOTIFY_REDIRECT_URI http://localhost:8888
- SPOTIFY_CLIENT_SECRET YOUR_CLIENT_SECRET
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

From the repository

Create an account on developer.spotify.com. Navigate to the dashboard.
Create an app with redirect_uri as http://localhost:8888. (You can choose any port you want but you must use http and localhost).
I set "APIs used" to "Web Playback SDK".

(todo)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "spotify": {
            "env": {
                "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
                "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
                "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
            },
            "args": [
                "--directory",
                "/path/to/spotify_mcp",
                "run",
                "spotify-mcp"
            ],
            "command": "uv"
        }
    }
}

Linux

{
    "env": {
        "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
        "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
    },
    "args": [
        "--directory",
        "/path/to/spotify_mcp",
        "run",
        "spotify-mcp"
    ],
    "command": "uv"
}

Macos

{
    "env": {
        "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
        "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
    },
    "args": [
        "--directory",
        "/path/to/spotify_mcp",
        "run",
        "spotify-mcp"
    ],
    "command": "uv"
}

Windows

{
    "env": {
        "SPOTIFY_CLIENT_ID": "YOUR_CLIENT_ID",
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888",
        "SPOTIFY_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
    },
    "args": [
        "--directory",
        "/path/to/spotify_mcp",
        "run",
        "spotify-mcp"
    ],
    "command": "uv"
}

spotify-mcp MCP server

MCP project to connect Claude with Spotify. Built on top of spotipy-dev's API.

Features

- Start, pause, and skip playback - Search for tracks/albums/artists/playlists - Get info about a track/album/artist/playlist - Manage the Spotify queue

Demo

Make sure to turn on audio

<details>
<summary>
Video
</summary>
https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894
</summary>
</details>

Configuration

Getting Spotify API Keys

Create an account on developer.spotify.com. Navigate to the dashboard. Create an app with redirect_uri as http://localhost:8888. (You can choose any port you want but you must use http and localhost). I set "APIs used" to "Web Playback SDK".

Run this project locally

This project is not yet set up for ephemeral environments (e.g. uvx usage). Run this project locally by cloning this repo

git clone https://github.com/varunneal/spotify-mcp.git

Add this tool as a mcp server.

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

  "spotify": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/spotify_mcp",
        "run",
        "spotify-mcp"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888"
      }
    }

Troubleshooting

Please open an issue if you can't get this MCP working. Here are some tips: 1. Make sure uv is updated. I recommend version >=0.54. 2. Make sure claude has execution permisisons for the project: chmod -R 755. 3. Ensure you have Spotify premium (needed for running developer API).

TODO

Unfortunately, a bunch of cool features have now been deprecated
from the Spotify API. Most new features will be relatively minor or for the health of the project:
- tests.
- adding API support for managing playlists.
- adding API support for paginated search results/playlists/albums.

Deployment

(todo)

Building and Publishing

To prepare the package for distribution:

1. Sync dependencies and update lockfile:

uv sync

2. Build package distributions:

uv build

This will create source and wheel distributions in the dist/ directory.

3. Publish to PyPI:

uv publish

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

spotify-mcp MCP server

Features

Demo

Configuration

Getting Spotify API Keys

Run this project locally

Troubleshooting

TODO

Deployment

Building and Publishing

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel