S
Spotify Plus MCP
by @omniwaifu
spotify mcp + lastfm / musicbrainz for search
Created 9/1/2025
Updated 6 days ago
README
Repository documentation and setup instructions
Spotify Plus MCP Server
MCP server for Spotify control.
Features
- Playback control (play, pause, skip, volume)
- Search (tracks, albums, artists, playlists)
- Queue management
- Playlist management
- Enhanced metadata from Last.fm and MusicBrainz
- Similar artist discovery
Setup
1. Get Spotify Credentials
- Create app at Spotify Developer Dashboard
- Set redirect URI:
http://127.0.0.1:8888/callback
- Save Client ID and Secret
2. Install
git clone https://github.com/omniwaifu/spotify-plus-mcp.git
cd spotify-plus-mcp
# Create .env
echo "SPOTIFY_CLIENT_ID=your_client_id" > .env
echo "SPOTIFY_CLIENT_SECRET=your_client_secret" >> .env
echo "SPOTIFY_REDIRECT_URI=http://127.0.0.1:8888/callback" >> .env
# Authenticate (one-time)
python auth.py
Tokens saved to ~/.spotify-mcp/spotify-config.json
.
3. Configure MCP
Add to config:
{
"mcpServers": {
"spotify": {
"command": "uv",
"args": [
"--directory",
"/path/to/spotify-plus-mcp",
"run",
"spotify-plus-mcp"
],
"env": {
"LASTFM_API_KEY": "optional_api_key"
}
}
}
}
Requirements
- Spotify Premium
- Python 3.12+
- uv
Troubleshooting
- No active device: Open Spotify on any device
- Auth failed: Run
python auth.py
- Permission denied: Need Spotify Premium
License
MIT
Quick Setup
Installation guide for this server
Install Package (if required)
uvx spotify-plus-mcp
Cursor configuration (mcp.json)
{
"mcpServers": {
"omniwaifu-spotify-plus-mcp": {
"command": "uvx",
"args": [
"spotify-plus-mcp"
]
}
}
}
Author Servers
Other servers by omniwaifu