Spotify
An MCP server that enables users to control Spotify playback, search for music, and manage playlists through MCP-compatible clients. It supports features like track recommendations and playback management using secure OAuth authentication.
What is Spotify?
Spotify is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that enables users to control spotify playback, search for music, and manage playlists through mcp-compatible clients. it supports features like track recommendations and playback managemen...
An MCP server that enables users to control Spotify playback, search for music, and manage playlists through MCP-compatible clients. It supports features like track recommendations and playback management using secure OAuth authentication.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- get_access_token
- search
- get_artist
- get_multiple_artists
- get_artist_top_tracks
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @thomaswawra/server-spotifyManual Installation
npx -y @thomaswawra/server-spotifyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Spotify
The Spotify MCP server enables AI assistants to control Spotify playback, search for music, manage playlists, and get personalized recommendations through the Spotify Web API using secure OAuth authentication. It exposes 15 tools covering playback control (play, pause, skip), search, playlist creation and management, queue control, and top-track retrieval. Music enthusiasts and developers use it to manage their listening experience hands-free through natural language commands in their AI client.
Prerequisites
- Node.js 18 or later installed
- A Spotify account (free or Premium; playback control requires Premium)
- A Spotify Developer App with Client ID and Client Secret (create at developer.spotify.com/dashboard)
- An MCP-compatible client such as Claude Desktop or Cursor
Create a Spotify Developer App
Go to developer.spotify.com/dashboard, log in, and create a new app. Set the redirect URI to http://127.0.0.1:8888/callback in the app settings. Copy the Client ID and Client Secret.
Clone and build the server
Clone the repository and install dependencies. The server is written in Kotlin/TypeScript and requires a build step.
git clone https://github.com/GraysonCAdams/spotify-mcp.git
cd spotify-mcp
npm ci
npm run buildConfigure your MCP client
Add the server entry to claude_desktop_config.json with your Spotify Client ID, Client Secret, and Redirect URI.
{
"mcpServers": {
"spotify": {
"command": "npx",
"args": ["-y", "@thomaswawra/server-spotify"],
"env": {
"SPOTIFY_CLIENT_ID": "your_client_id",
"SPOTIFY_CLIENT_SECRET": "your_client_secret",
"SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8888/callback"
}
}
}
}Restart Claude Desktop
Restart the client to load the Spotify server.
Authenticate with Spotify
In your AI client, use the 'auth-spotify' tool to trigger the browser-based OAuth flow. A browser window will open — log in and authorize the app. The server stores the access token locally.
Start using Spotify through your AI client
Once authenticated, you can search for music, control playback, and manage playlists through natural language prompts.
Spotify Examples
Client configuration
Claude Desktop configuration for the Spotify MCP server with OAuth credentials.
{
"mcpServers": {
"spotify": {
"command": "npx",
"args": ["-y", "@thomaswawra/server-spotify"],
"env": {
"SPOTIFY_CLIENT_ID": "your_client_id_here",
"SPOTIFY_CLIENT_SECRET": "your_client_secret_here",
"SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8888/callback"
}
}
}
}Prompts to try
Example prompts for controlling Spotify through the MCP server.
- "Play some lo-fi hip hop on my Spotify."
- "Search for songs by Radiohead and play the top result."
- "Create a new playlist called 'Focus Mode' and add 10 instrumental tracks to it."
- "What are my top tracks this month?"
- "Skip to the next song and turn the volume up to 80%."Troubleshooting Spotify
OAuth redirect fails or browser does not open
Ensure the redirect URI in your Spotify Developer App settings exactly matches SPOTIFY_REDIRECT_URI in your config (http://127.0.0.1:8888/callback). Port 8888 must be free on your machine.
Playback control not working (play/pause/skip have no effect)
Playback control requires a Spotify Premium account. Also ensure Spotify is open and active on at least one device before issuing playback commands.
Client ID or Client Secret invalid error
Double-check that you copied the credentials from the correct Spotify Developer App at developer.spotify.com/dashboard. Credentials are case-sensitive and must not contain extra spaces.
Frequently Asked Questions about Spotify
What is Spotify?
Spotify is a Model Context Protocol (MCP) server that mcp server that enables users to control spotify playback, search for music, and manage playlists through mcp-compatible clients. it supports features like track recommendations and playback management using secure oauth authentication. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Spotify?
Install via npm with the command: npx -y @thomaswawra/server-spotify. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Spotify?
Spotify works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Spotify free to use?
Yes, Spotify is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Spotify Alternatives — Similar Communication Servers
Looking for alternatives to Spotify? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Spotify in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Spotify?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.