Spotify

v1.0.0Communicationstable

Enables interaction with Spotify through natural language for music discovery, playback control, library management, and playlist creation. Supports searching for music, controlling playback, managing saved tracks, and getting personalized recommenda

spotify-mcp-servermcpai-integration
Share:
344
Stars
0
Downloads
0
Weekly
0/5

What is Spotify?

Spotify is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interaction with spotify through natural language for music discovery, playback control, library management, and playlist creation. supports searching for music, controlling playback, managing...

Enables interaction with Spotify through natural language for music discovery, playback control, library management, and playlist creation. Supports searching for music, controlling playback, managing saved tracks, and getting personalized recommenda

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables interaction with Spotify through natural language fo

Use Cases

Search music and discover new tracks
Control playback and manage playlists
Get personalized recommendations
marcelmarais

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx spotify-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Spotify

Spotify MCP Server connects AI assistants directly to the Spotify API, enabling natural language control over music playback, library management, and playlist creation. It exposes 27 tools covering everything from searching for tracks and albums to controlling volume, managing queues, and generating personalized playlists. Built on Spotify's OAuth flow, it requires a Spotify Developer app for authentication and works with any MCP-compatible client including Claude Desktop.

Prerequisites

  • Node.js 18 or higher and npm installed
  • A Spotify account (free or premium; playback control requires Spotify Premium)
  • A Spotify Developer app with clientId and clientSecret from https://developer.spotify.com/dashboard
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository and install dependencies

Clone the Spotify MCP Server repository from GitHub and install its Node.js dependencies.

git clone https://github.com/marcelmarais/spotify-mcp-server.git
cd spotify-mcp-server
npm install
npm run build
2

Create a Spotify Developer app

Go to https://developer.spotify.com/dashboard, create a new app, and note your Client ID and Client Secret. Set the Redirect URI to http://127.0.0.1:8888/callback in the app settings.

3

Configure spotify-config.json

Create a spotify-config.json file in the project directory with your Spotify Developer credentials. The accessToken and refreshToken fields will be populated after the first OAuth authentication flow.

{
  "clientId": "your_spotify_client_id",
  "clientSecret": "your_spotify_client_secret",
  "redirectUri": "http://127.0.0.1:8888/callback",
  "accessToken": "",
  "refreshToken": "",
  "expiresAt": 0
}
4

Run the authentication flow

Run the auth script to open a browser window for Spotify OAuth login. After authorizing, the accessToken and refreshToken will be saved to spotify-config.json automatically.

node auth.js
5

Add the server to your MCP client configuration

Configure Claude Desktop to use the locally built Spotify MCP Server by pointing to the built index.js file.

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/absolute/path/to/spotify-mcp-server/build/index.js"]
    }
  }
}
6

Restart Claude Desktop and start using Spotify

Restart Claude Desktop. The 27 Spotify tools will now be available. Try asking Claude to search for music, control playback, or create a playlist.

Spotify Examples

Client configuration (Claude Desktop)

Full claude_desktop_config.json entry for the locally built Spotify MCP Server.

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/absolute/path/to/spotify-mcp-server/build/index.js"]
    }
  }
}

Prompts to try

Example prompts that work well once the Spotify MCP Server is connected to Claude Desktop.

- "Play Elvis's first hit song on my Spotify"
- "Create a Taylor Swift and Slipknot fusion playlist with 20 tracks"
- "What's currently playing and turn the volume down a bit"
- "Add the last 10 songs I liked to my workout playlist"
- "Skip to the next track and show me the queue"

Troubleshooting Spotify

Playback control commands fail or return 403 errors

Playback control (play, pause, skip, volume) requires a Spotify Premium account. Free accounts can search and manage playlists but cannot control playback via the API.

Access token expired and music commands stop working

The server automatically refreshes tokens using the refreshToken stored in spotify-config.json. If this fails, re-run 'node auth.js' to generate a fresh token pair.

No active device found error when trying to play music

Open the Spotify app on any device (desktop, mobile, or web player) and start playback there first. The MCP server requires an active Spotify device to be connected before it can control playback.

Frequently Asked Questions about Spotify

What is Spotify?

Spotify is a Model Context Protocol (MCP) server that enables interaction with spotify through natural language for music discovery, playback control, library management, and playlist creation. supports searching for music, controlling playback, managing saved tracks, and getting personalized recommenda It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Spotify?

Follow the installation instructions on the Spotify GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

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.

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.

Quick Config Preview

{ "mcpServers": { "spotify-mcp-server": { "command": "npx", "args": ["-y", "spotify-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides