클로드와 스포티파이를 연결하는 MCP 프로젝트. spotipy-dev의 API 위에 구축됨.

[2026년 3월 공지]: 비활성 프로젝트. 대부분의 PR은 통합되지 않습니다.

특징

• 재생 시작, 일시정지, 스킵
• 트랙/앨범/아티스트/플레이리스트 검색
• 트랙/앨범/아티스트/플레이리스트에 대한 정보 얻기
• 스포티파이 대기열 관리
• 재생목록을 관리, 생성 및 업데이트

데모

비디오 – 오디오 켜

https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894

구성

Spotify API 키 얻기

developer.spotify.com 에서 계정을 생성하세요. 대시보드로 이동하세요.
redirect_uri http://127.0.0.1:8080/callback.로 앱을 만드세요. 원하는 포트 중 어느 것이든 선택할 수 있지만, 반드시 http와 명시적인 루프백 주소(IPv4 또는 IPv6)를 사용해야 합니다.

자세한 정보와 문제 해결은 여기를 참조하세요.
MCP 환경(예: Claude Desktop)을 한두 번 재시작해야 작동할 수도 있습니다.

MCP 설정 위치 찾기

커서, Claude Desktop 또는 다른 MCP 지원 클라이언트는 설정을 찾아야 합니다.

• MacOS의 Claude 데스크톱 위치: ~/Library/Application\ Support/Claude/claude_desktop_config.json

spotify-mcp MCP server

MCP project to connect Claude with Spotify. Built on top of spotipy-dev’s API.

[Notice March 2026]: Inactive project. Most PRs will not be merged.

Features

• Start, pause, and skip playback
• Search for tracks/albums/artists/playlists
• Get info about a track/album/artist/playlist
• Manage the Spotify queue
• Manage, create, and update playlists

Demo

Configuration

Getting Spotify API Keys

Create an account on developer.spotify.com. Navigate to the dashboard. Create an app with redirect_uri as http://127.0.0.1:8080/callback. You can choose any port you want but you must use http and an explicit loopback address (IPv4 or IPv6).

See here for more info/troubleshooting. You may have to restart your MCP environment (e.g. Claude Desktop) once or twice before it works.

Locating MCP Config

For Cursor, Claude Desktop, or any other MCP-enabled client you will have to locate your config.

• Claude Desktop location on MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

• Claude Desktop location on Windows: %APPDATA%/Claude/claude_desktop_config.json

Run this project with uvx

Add this snippet to your MCP Config.

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "git+https://github.com/varunneal/spotify-mcp",
        "spotify-mcp"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
      }
    }
  }
}

Run this project locally

Using UVX will open the spotify redirect URI for every tool call. To avoid this, you can run this project locally by cloning this repo:

git clone https://github.com/varunneal/spotify-mcp.git

Add it to your MCP Config like this:

"spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify-mcp",
      "run",
      "spotify-mcp"
    ],
    "env": {
      "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
      "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
      "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
    }
  }

Troubleshooting

Please open an issue if you can’t get this MCP working. Here are some tips:

1. Make sure uv is updated. I recommend version >=0.54.
2. If cloning locally, enable execution permisisons for the project: chmod -R 755.
3. Ensure you have Spotify premium (needed for running developer API).