Spotify Integration

v1.0.0Communicationstable

An integration that allows Claude Desktop to interact with Spotify, enabling users to control playback, search music, manage playlists, and get recommendations through natural language commands.

aiclaudeclaude-aiclaude-desktopmcp
Share:
35
Stars
0
Downloads
0
Weekly
0/5

What is Spotify Integration?

Spotify Integration is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to integration that allows claude desktop to interact with spotify, enabling users to control playback, search music, manage playlists, and get recommendations through natural language commands.

An integration that allows Claude Desktop to interact with Spotify, enabling users to control playback, search music, manage playlists, and get recommendations through natural language commands.

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

Features

  • An integration that allows Claude Desktop to interact with S

Use Cases

Control music playback and search
Manage playlists
Get music recommendations
imprvhub

Maintainer

LicenseMozilla Public License 2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 3, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-claude-spotify

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 Integration

MCP Claude Spotify is a Node.js-based MCP server that connects Claude Desktop to the Spotify Web API, enabling full music control through natural language. Once configured, you can search for tracks, albums, artists, and playlists; control playback (play, pause, skip, previous); manage your playlists; retrieve personalized recommendations; and view recently played tracks — all without leaving your AI conversation. It uses OAuth 2.0 to authenticate with Spotify and requires a Spotify Developer app for API credentials.

Prerequisites

  • Node.js 16 or higher installed
  • A Spotify account (free or Premium; Premium required for playback control on some devices)
  • A Spotify Developer app with Client ID and Client Secret (created at developer.spotify.com/dashboard)
  • Redirect URI 'http://127.0.0.1:8888/callback' added to your Spotify app's allowed redirect URIs
  • Claude Desktop installed and running
1

Clone the repository and install dependencies

Clone the mcp-claude-spotify repository and install its Node.js dependencies. The repository includes pre-built files so you can skip the build step if you are not modifying the source.

git clone https://github.com/imprvhub/mcp-claude-spotify
cd mcp-claude-spotify
npm install
2

Create a Spotify Developer app and get credentials

Go to developer.spotify.com/dashboard, click 'Create App', fill in the app name and description, and add 'http://127.0.0.1:8888/callback' as a Redirect URI. Save the Client ID and Client Secret from the app dashboard.

3

Configure Claude Desktop with the Spotify MCP server

Edit your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Replace the path and credentials with your actual values.

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-claude-spotify/build/index.js"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}
4

Restart Claude Desktop and authenticate with Spotify

Fully restart Claude Desktop. In a Claude conversation, call the 'auth-spotify' tool to begin the OAuth flow. A browser window will open for you to log in and authorize the app.

5

Restart Claude Desktop again after authenticating

After successful Spotify authorization, restart Claude Desktop one more time. This step is required to properly initialize the MCP tool registry and WebSocket session token cache so all Spotify tools are available.

Spotify Integration Examples

Client configuration (Claude Desktop)

Claude Desktop configuration for the Spotify MCP server using locally cloned and built files with Spotify API credentials.

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/Users/yourname/mcp-claude-spotify/build/index.js"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_spotify_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_spotify_client_secret"
      }
    }
  }
}

Prompts to try

After authenticating, use these natural language prompts to control Spotify through Claude.

- "Search Spotify for jazz piano albums and play the first result"
- "Pause my current Spotify playback"
- "Skip to the next track"
- "Create a new Spotify playlist called 'Focus Music'"
- "Show me my top 10 most played tracks from the last 6 months"
- "Get me recommendations based on my recently played tracks"

Troubleshooting Spotify Integration

OAuth callback fails or browser does not open during auth-spotify

Ensure the redirect URI 'http://127.0.0.1:8888/callback' is added exactly as shown in your Spotify Developer app settings under 'Redirect URIs'. Port 8888 must be free on your machine. Check for firewall rules blocking localhost connections.

Playback control tools return errors even after authentication

Spotify's playback API requires an active device with Spotify open. Open the Spotify app on any device, start playing something manually once, then use the MCP tools. Some features require a Spotify Premium subscription.

Spotify tools are not visible in Claude after configuration

Make sure you have restarted Claude Desktop twice: once after editing claude_desktop_config.json and again after completing the Spotify OAuth flow. Also verify that the absolute path to build/index.js in your config matches the actual file location on disk.

Frequently Asked Questions about Spotify Integration

What is Spotify Integration?

Spotify Integration is a Model Context Protocol (MCP) server that integration that allows claude desktop to interact with spotify, enabling users to control playback, search music, manage playlists, and get recommendations through natural language commands. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Spotify Integration?

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

Which AI clients work with Spotify Integration?

Spotify Integration works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Spotify Integration free to use?

Yes, Spotify Integration is open source and available under the Mozilla Public License 2.0 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": { "mcp-claude-spotify": { "command": "npx", "args": ["-y", "mcp-claude-spotify"] } } }

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

Read the full setup guide →

Ready to use Spotify Integration?

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