spotify-mcp
Play your favorite song without leaving Cursor
Documentation
Spotify MCP Server
This project implements a Model Context Protocol (MCP) server that allows you to control Spotify playback using natural language through an MCP client, such as Cursor or Claude for Desktop (macOS and Windows only).
Features
This server exposes the following tools:
- `play`: Play a track, album, or playlist, or resume playback.
- `pause`: Pause playback.
- `next`: Skip to the next track.
- `previous`: Skip to the previous track.
- `get_current_track`: Get information about the currently playing track.
- `search`: Search for tracks, albums, artists, or playlists.
Prerequisites
- Bun (version 1.0.0 or later)
- A Spotify Premium account.
- A Spotify Developer application:
- An MCP client (e.g., Cursor or Claude for Desktop).
Installation and Setup
1. Clone the repository:
git clone https://github.com/obre10off/spotify-mcp.git
cd spotify-mcp2. Install dependencies:
bun install3. Create a `.env` file:
Create a file named `.env` in the root of the project directory. Add the following, replacing the placeholders with your actual Spotify credentials:
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:8888/callback
# These will be filled in after running the auth script:
SPOTIFY_ACCESS_TOKEN=
SPOTIFY_REFRESH_TOKEN=4. Run the authorization script:
This script will open your browser, prompt you to log in to Spotify and grant permissions, and then retrieve your initial access and refresh tokens.
bun run authThe script will print the `SPOTIFY_ACCESS_TOKEN` and `SPOTIFY_REFRESH_TOKEN` to the console. Copy these values into your `.env` file.
5. Configure your MCP client:
{
"mcp.servers": [
{
"spotify": {
"command": "bun",
"args": ["/absolute/path/to/your/spotify-mcp/src/index.ts"],
"env": {
"SPOTIFY_CLIENT_ID": "your_spotify_client_id",
"SPOTIFY_CLIENT_SECRET": "your_spotify_client_secret",
"SPOTIFY_REDIRECT_URI": "http://localhost:8888/callback",
"SPOTIFY_ACCESS_TOKEN": "your_spotify_access_token",
"SPOTIFY_REFRESH_TOKEN": "your_spotify_refresh_token"
}
}
}
]
}It is recommended to use a `.env` file and only put the environment variables related to Spotify there, instead of adding the values to the settings.json file.
{
"mcpServers": {
"spotify": {
"command": "bun",
"args": ["/absolute/path/to/your/spotify-mcp/src/index.ts"]
}
}
}It is recommended to use a `.env` file and only put the environment variables related to Spotify there, instead of adding the values to the `claude_desktop_config.json` file.
6. Restart your MCP Client
Make sure to restart your MCP client (Cursor/Claude) to apply the settings.
Running the Server
bun run start
This command starts the server with automatic reloading on file changes (thanks to Bun's --watch flag). Keep this terminal window open while you're using the server.
## Usage
Once the server is running and your MCP client is configured, you can start using natural language commands to control Spotify. Examples:
"Play Bohemian Rhapsody"
"Pause the music"
"What song is playing?"
"Search for Taylor Swift albums"
"Next track"
"Play spotify:track:4uLU6hMCjMI75M1A2tKUQC"Frequently asked questions
What is spotify-mcp?
spotify-mcp is Play your favorite song without leaving Cursor
How do I install spotify-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is spotify-mcp open source?
Yes — it is hosted on GitHub at https://github.com/obre10off/spotify-mcp and has 1 stars.
Related MCP tools
Model Context Protocol Servers
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
MCP server to provide Figma layout information to AI coding agents like Cursor
The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Instant is the best backend for AI-coded apps. You get auth, permissions, storage, presence, and streams — everything you need to ship apps your users will love.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP