Проект MCP для соединения Claude со Spotify. Построен на основе API spotipy-dev.

[Уведомление, март 2026]: проект неактивен. Большинство 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) один-два раза, прежде чем она заработает.

Поиск конфигурации MCP

Для Cursor, Claude Desktop или любого другого клиента с поддержкой MCP вам нужно будет найти свою конфигурацию.

• Местоположение рабочего стола Claude на MacOS: ~/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).