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" } } } }