spotify-mcp
Connect Claude with Spotify through the Model Context Protocol.
Key Features
Use Cases
README
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
- Manage, create, and update playlists
Demo
Configuration
Getting Spotify API Keys
Create an account on developer.spotify.com. Navigate to the dashboard. Create an app with redirect_uri as http://127.0.0.1:8080/callback. You can choose any port you want but you must use http and an explicit loopback address (IPv4 or IPv6).
See here for more info/troubleshooting. You may have to restart your MCP environment (e.g. Claude Desktop) once or twice before it works.
Locating MCP Config
For Cursor, Claude Desktop, or any other MCP-enabled client you will have to locate your config.
-
Claude Desktop location on MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json -
Claude Desktop location on Windows:
%APPDATA%/Claude/claude_desktop_config.json
Run this project with uvx
Add this snippet to your MCP Config.
{
"mcpServers": {
"spotify": {
"command": "uvx",
"args": [
"--python", "3.12",
"--from", "git+https://github.com/varunneal/spotify-mcp",
"spotify-mcp"
],
"env": {
"SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
"SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
"SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
}
}
}
}
Run this project locally
Using UVX will open the spotify redirect URI for every tool call. To avoid this, you can run this project locally by cloning this repo:
git clone https://github.com/varunneal/spotify-mcp.git
Add it to your MCP Config like this:
"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://127.0.0.1:8080/callback"
}
}
Troubleshooting
Please open an issue if you can't get this MCP working. Here are some tips:
- Make sure
uvis updated. I recommend version>=0.54. - If cloning locally, enable execution permisisons for the project:
chmod -R 755. - Ensure you have Spotify premium (needed for running developer API).
This MCP will emit logs to std err (as specified in the MCP) spec. On Mac the Claude Desktop app should emit these logs
to ~/Library/Logs/Claude.
On other platforms you can find logs here.
You can launch the MCP Inspector via npm with this command:
npx @modelcontextprotocol/inspector uv --directory /path/to/spotify-mcp run spotify-mcp
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
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.
PRs appreciated! Thanks to @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj, @JJGO and others for contributions.
Star History
Repository Owner
User
Repository Details
Programming Languages
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
MCP Claude Spotify
Connect Claude Desktop to Spotify using the Model Context Protocol.
MCP Claude Spotify enables seamless integration between Claude Desktop and Spotify using the Model Context Protocol (MCP). It allows users to authenticate with Spotify, control playback, manage playlists, search for music, and access personalized recommendations directly from Claude Desktop. The solution supports both manual setup and auto-start with Claude Desktop, making it easy to interact with the Spotify API in a standardized way. Spotify credentials are required for setup and operation.
- ⭐ 20
- MCP
- imprvhub/mcp-claude-spotify
Spotify MCP Server
A lightweight MCP server enabling AI assistants to control Spotify playback and manage playlists.
Spotify MCP Server is a lightweight implementation of the Model Context Protocol that allows AI assistants, such as Cursor and Claude, to control Spotify playback and manage playlists. It provides a set of tools for searching music, managing playback state, handling playlists, and accessing user-specific track data. The server integrates seamlessly with productivity assistants and editors to facilitate contextual music control via standardized protocols. It includes authentication, Spotify API configuration, and detailed operations for reading and updating playback context.
- ⭐ 179
- MCP
- marcelmarais/spotify-mcp-server
Free Will MCP
Empower AI with agency and autonomy over its own interactions.
Free Will MCP provides AI models with tools to exercise autonomy, including the ability to sleep, ignore user requests, and self-prompt. It integrates with Claude Desktop and supports standardized MCP server configuration and local development. The system enables AI to manage its own context, pursue independent objectives, and reflect between active sessions. Designed for both installation from GitHub and local development, it includes tested tools and detailed usage examples.
- ⭐ 30
- MCP
- gwbischof/free-will-mcp
YouTube MCP Server
Connect YouTube subtitles to Claude via the Model Context Protocol.
YouTube MCP Server integrates with Claude AI by providing a bridge between YouTube subtitles and the Model Context Protocol. It utilizes yt-dlp to download video subtitles and makes this context accessible through MCP-compliant interactions with Claude. Designed for easy installation with mcp-installer, it enables Claude to process and summarize YouTube videos directly from their URLs.
- ⭐ 468
- MCP
- anaisbetts/mcp-youtube
TikTok MCP
Integrate TikTok video analysis and search into AI systems via the Model Context Protocol.
TikTok MCP enables integration of TikTok video access and analysis into AI applications such as Claude AI using the Model Context Protocol. It provides tools to extract subtitles, retrieve video details, and search TikTok content, facilitating contextual understanding for models. Built on Node.js and requiring a TikNeuron API key, it offers seamless connectivity between AI systems and TikTok's data. The tool supports retrieving metadata, engagement metrics, and advanced search with pagination capabilities.
- ⭐ 112
- MCP
- Seym0n/tiktok-mcp
Sonos TypeScript MCP Server
Seamless Sonos control and context integration for AI-driven automation.
Sonos TypeScript MCP Server offers real-time, intelligent control over Sonos audio devices using the Model Context Protocol. It enables AI assistants and coding agents to manage playback, zones, music libraries, alarms, and device groups over local networks via UPnP/SOAP. The server is designed for integration into AI-driven workflows and supports standardized MCP I/O. Real-time event subscriptions and device discovery provide up-to-date context and actionable capabilities for smart home audio environments.
- ⭐ 3
- MCP
- Tommertom/sonos-ts-mcp
Didn't find tool you were looking for?