GK

gupta-kush/spotify-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

10 stars 4 forks 品質 75 トレンド 18MIT

Control Spotify from Claude, Cursor, or any MCP client. 100+ tools for playback, playlists, discovery, and curation.

概要

Control Spotify from Claude, Cursor, or any MCP client. for playback, search, playlist management, smart shuffle, vibe analysis, natural language song search, artist exploration, and library indexing. Just uvx spotify-mcp to get started. Go to the Spotify Developer Dashboard, create an app, set the redirect URI to http://127.0.0.1:8888/callback, check , and copy your . No client secret needed (PKCE auth). Then set your client ID: claude mcp add spotify -e SPOTIFY_CLIENT_ID=your_client_id -- uvx spotify-mcp (same config, but load only core tools to stay under the 40-tool limit): Or install with pip: pip install spotify-mcp The first time you use a Spotify tool, your browser opens for OAuth. Grant access and the token is cached locally. There are 30+ Spotify MCP servers out there. Most have 10-15 tools covering play, pause, and search.

README

以下は原文 README の抜粋です。原文を見る。

Spotify MCP Server

Control Spotify from Claude, Cursor, or any MCP client. 100+ tools for playback, search, playlist management, smart shuffle, vibe analysis, natural language song search, artist exploration, and library indexing. Just uvx spotify-mcp to get started.

Quick Start

1. Get a Spotify Client ID

Go to the Spotify Developer Dashboard, create an app, set the redirect URI to http://127.0.0.1:8888/callback, check Web API, and copy your Client ID. No client secret needed (PKCE auth).

2. Install and Configure

Claude Code (one command):

claude mcp add spotify -- uvx spotify-mcp

Then set your client ID: claude mcp add spotify -e SPOTIFY_CLIENT_ID=your_client_id -- uvx spotify-mcp

Claude Desktop (add to claude_desktop_config.json):

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": ["spotify-mcp"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id"
      }
    }
  }
}

Cursor / VS Code (same config, but load only core tools to stay under the 40-tool limit):

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": ["spotify-mcp", "--toolsets=core"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id"
      }
    }
  }
}

Or install with pip: pip install spotify-mcp

3. Authorize

The first time you use a Spotify tool, your browser opens for OAuth. Grant access and the token is cached locally.

Why this one?

There are 30+ Spotify MCP servers out there. Most have 10-15 tools covering play, pause, and search.

spotify-mcp Typical server
Tools 100+ 5-15
Smart shuffle (6 strategies incl. energy arcs) Yes No
Vibe engine (mood analysis without audio-features) Yes No
Natural language song search Yes No
Artist network mapping (100 related artists) Yes No
Taste evolution tracking Yes No
Library index (AI playlists from your own songs) Yes No
Destructive tools stripped by default Yes No
GitHub で README 全文を見る

インストール

uvx spotify-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "spotify": { "command": "uvx", "args": ["spotify-mcp"], "env": { "SPOTIFY_CLIENT_ID": "your_client_id" } } } }