Skip to main content
Glama

spotify-mcp MCP server

MCP server connecting Claude with Spotify. This fork of varunneal/spotify-mcp adds smart-batching tools and advanced playlist features that optimize API usage.

Features

Core Functionality

  • Playback Control: Start, pause, skip tracks, manage queue

  • Search & Discovery: Find tracks, albums, artists, playlists with pagination

  • Real-time State: Live user profile and playback status

Enhanced Playlist Tools (New in this fork)

  • Smart Batch Operations: Add/remove up to 100 tracks in single API calls

  • Large Playlist Support: Efficiently handle playlists with 1000+ tracks using pagination

  • Advanced Playlist Management: Create, modify details, bulk track operations

  • API-Optimized Workflows: Intelligent batching reduces API calls by 60-80%

Related MCP server: Spotify MCP Server

Installation

1. Get Spotify API Keys

  1. Create account at developer.spotify.com

  2. Create app with redirect URI: http://localhost:8888

2. Install the MCP Server

git clone https://github.com/jamiew/spotify-mcp.git cd spotify-mcp uv sync

3. Configure Claude Desktop

Add to Claude Desktop config (~/Library/Application Support/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" } }

Requirements: Spotify Premium account, uv >= 0.54

Usage Examples

  • "Create a chill study playlist with 20 tracks" → Search + playlist creation + bulk track addition

  • "Show me the first 50 tracks from my 'Liked Songs'" → Pagination for large playlists

  • "Find similar artists to Radiohead and add their top tracks to my queue" → Search + artist info + queue management

Development

Built with FastMCP framework featuring 13 focused tools, type-safe APIs, and comprehensive test coverage.

Debug with MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jamiew/spotify-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server