N1KH1LT0X1N/SpotifyMCP
If you are the rightful owner of SpotifyMCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
A comprehensive Model Context Protocol (MCP) server for Spotify, enabling AI assistants to control playback, manage playlists, search music, and more.
🎵 Spotify MCP Server
Control Spotify with natural language through Claude Desktop.
75 tools • 10 resources
⚡ Quick Start
# 1. Install
pip install -e .
# 2. Authenticate with Spotify
python -m spotify_mcp.auth
# 3. Add to Claude Desktop config (see docs/setup/QUICK_SETUP.md)
📖 Full Setup Guide:
🎯 What You Can Do
Just talk naturally:
| Category | Examples |
|---|---|
| Playback | "Play my Discover Weekly" • "Skip this song" • "Volume to 50%" |
| Search | "Find chill jazz" • "Search for Radiohead albums" |
| Library | "Save this track" • "Show my top artists" |
| Playlists | "Create a workout playlist" • "Add this to my queue" |
| Discovery | "What's new this week?" • "Show artist's top tracks" |
🛠️ Tools (75)
| Category | Count | Description |
|---|---|---|
| Playback | 12 | Play, pause, skip, volume, shuffle, seek |
| Playlists | 12 | Create, modify, follow, manage covers |
| Albums | 8 | Browse, save, new releases |
| User | 8 | Profile, top items, following |
| Shows | 7 | Podcasts and episodes |
| Episodes | 6 | Save and manage podcast episodes |
| Artists | 4 | Details, discography, top tracks |
| Library | 4 | Saved tracks management |
| Categories | 2 | Browse categories |
| Queue | 2 | View and add to queue |
| Tracks | 2 | Track details |
| Search | 1 | Universal search |
| Markets | 1 | Available markets |
| Composite | 6 | Multi-step operations (create playlists, analyze listening) |
Note: Audiobooks, Chapters, and Genre Seeds are deprecated by Spotify's API changes.
📖 Full Tool Reference:
📋 Requirements
- Python 3.10+
- Spotify account (Premium for playback control)
- Spotify Developer App
🔧 Configuration
Claude Desktop
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"spotify": {
"command": "python",
"args": ["-m", "spotify_mcp.spotify_server"],
"env": {
"SPOTIFY_CLIENT_ID": "your_client_id",
"SPOTIFY_CLIENT_SECRET": "your_client_secret",
"SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8888/callback",
"PYTHONPATH": "/path/to/spotify_mcp/src"
}
}
}
}
🐛 Troubleshooting
| Issue | Solution |
|---|---|
ModuleNotFoundError | Set PYTHONPATH to src directory |
| No tokens | Run python -m spotify_mcp.auth |
| Invalid redirect URI | Use 127.0.0.1 not localhost |
| No active device | Open Spotify on any device |
| Premium required | Playback control needs Premium |
📖 Full Guide:
📚 Documentation
| Document | Description |
|---|---|
| Get started in 5 minutes | |
| All 75 tools explained | |
| Resources, prompts, schemas | |
| Production deployment guide | |
| FastMCP v3.0 implementation | |
| System design |
🚀 Development
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Code quality
black src/ tests/
isort src/ tests/
📄 License
MIT License - see
• •
Made with 🎵 for the AI + Music community