ClaudeとSpotifyを接続するためのMCPプロジェクト。spotipy-devのAPIの上に構築されています。

[2026年3月通知]:非活動プロジェクト。ほとんどのPRは統合されません。

特徴

• 再生開始、一時停止、スキップ
• トラック/アルバム/アーティスト/プレイリストの検索
• トラック/アルバム/アーティスト/プレイリストに関する情報を取得
• Spotifyのキュー管理
• プレイリストの管理、作成、更新

デモ

ビデオ――音声をオンにしてください

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)を1、2回再起動する必要があるかもしれません。

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).