Spotify MCP by obre10off
obre10offLABSCO SUMMARY
Deliberately three things.
There is no library browsing, no playlist management, no search — which means nothing to read through when you just want the music to stop. The one non-obvious dependency is that Spotify's API acts on an active device, so this controls a session you already have running rather than starting one from nothing.
What it is
A small Spotify controller. It starts and stops playback on your active device, reports what is playing now, and saves the current track to your Liked Songs — the three things you actually reach for while doing something else. It runs locally against your own Spotify developer app.
What you get
- Start and pause playback on your active Spotify device
- Read back what is playing right now — title and artist
- Add the currently playing track to your Liked Songs
Requirements
Register an app at the Spotify Developer Dashboard and put SPOTIPY_CLIENT_ID, SPOTIPY_CLIENT_SECRET and SPOTIPY_REDIRECT_URI in a .env file. Clone the repository, create a virtualenv, pip install -r requirements.txt, and point your client at uv --directory <YOUR_PATH_TO_PROJECT_SPOTIFY_MCP_SERVER> run main.py. The project has no package of its own — the spotify-mcp-server name on PyPI belongs to a different author's server. Playback control needs an active Spotify device, so something has to be open for it to act on.
Setup effort
Build from source — git clone https://github.com/mfteloglu/spotify-mcp-server.git
USE CASES
01
Pausing without switching windows
Stop or resume playback on whatever device is currently active.
02
Finding out what this song is
Read the title and artist of the track playing right now.
03
Saving something you just heard
Add the current track to your Liked Songs in one request.
BEFORE YOU INSTALL
What to know first
Requires
- uv on PATH
- A Spotify app registered at the Spotify Developer Dashboard, for its client ID and secret
- SPOTIPY_CLIENT_ID, SPOTIPY_CLIENT_SECRET and SPOTIPY_REDIRECT_URI in a .env file in the project folder
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
Clone the repository:
TERMINAL
git clone https://github.com/mfteloglu/spotify-mcp-server.git
cd spotify-mcp-serverCreate and activate a virtual environment:
TERMINAL
python3 -m venv .venv
source .venv/bin/activateInstall dependencies:
TERMINAL
pip install uv
pip install -r requirements.txtCreate a .env file:
In the spotify-mcp-server folder, set SPOTIPY_CLIENT_ID and SPOTIPY_CLIENT_SECRET to your app's values from the Spotify Developer Dashboard, and SPOTIPY_REDIRECT_URI to http://localhost:8888/callback
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"spotify-mcp-server": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_PROJECT_SPOTIFY_MCP_SERVER>",
"run",
"main.py"
]
}
}
}The configuration on this page does not set SPOTIPY_CLIENT_ID, SPOTIPY_CLIENT_SECRET or SPOTIPY_REDIRECT_URI. The server reads them from the .env file in the project folder.
