Yandex Music MCP for taste analysis

Yandex Music MCP

A single-file, zero-install Yandex Music MCP server via uv: likes, playlists, search and taste analysis

maxecho/yandex-music-mcpAuthor:Yaroslav Lashch

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/maxecho-yandex-music-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Assembled automatically, review before installing.

Run in a terminal

claude mcp add --transport stdio --env 'YANDEX_MUSIC_TOKEN=<your YANDEX_MUSIC_TOKEN>' yandex-music -- uvx run /path/to/yandex_music_mcp.py

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"yandex-music","type":"stdio","command":"uvx","args":["run","/path/to/yandex_music_mcp.py"],"env":{"YANDEX_MUSIC_TOKEN":"<your YANDEX_MUSIC_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "yandex-music": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add yandex-music --env 'YANDEX_MUSIC_TOKEN=<your YANDEX_MUSIC_TOKEN>' -- uvx run /path/to/yandex_music_mcp.py

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.yandex-music]
command = "uvx"
args = ["run", "/path/to/yandex_music_mcp.py"]
env = { YANDEX_MUSIC_TOKEN = "<your YANDEX_MUSIC_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user -e 'YANDEX_MUSIC_TOKEN=<your YANDEX_MUSIC_TOKEN>' yandex-music uvx run /path/to/yandex_music_mcp.py

Or add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "yandex-music": {
      "type": "local",
      "command": [
        "uvx",
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "environment": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<your YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YANDEX_MUSIC_TOKENsecret, required: Yandex Music API token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 26, 2026, commit 1ca416b.

Text for your agent

Install uv, get a token with the Yandex Music Token extension, add the server to claude_desktop_config.json running uv run /path/to/yandex_music_mcp.py with the YANDEX_MUSIC_TOKEN variable, and fully restart Claude Desktop.

Other ways from the author

{
  "mcpServers": {
    "yandex-music": {
      "command": "/Users/YOU/.local/bin/uv",
      "args": ["run", "/path/to/yandex_music_mcp.py"],
      "env": { "YANDEX_MUSIC_TOKEN": "your_token_here" }
    }
  }
}

Snippet for claude_desktop_config.json from the README.

This is third-party code. Review the repository files before installing.

What it does

The server is a single Python file with PEP 723 inline dependencies; uv installs them on first run, no separate setup needed. Tools: connection and Plus-status check, paginated liked tracks, playlist listing and their tracks, catalog search, playlist creation, adding and removing tracks, liking tracks. The README offers a ready scenario: the agent reads several pages of likes, runs a short interview about taste and listening scenarios, and builds personal playlists from that.

Who it is for. For those who want to hook up Yandex Music to Claude quickly with no build step, and get their taste analyzed.

Good fit when

You want one-line install with no cloning or build step: just uv and a token
You want a ready taste-analysis scenario that builds playlists for your life scenarios
It works with any MCP client, not only Claude Code and Desktop

Not a fit when

You need genre analysis or an instrumental-track filter: not present here, only basic operations
You need actual audio playback: the server only reads and changes data, it does not play music

Example request

Analyze my likes, what do I even listen to, and build a 40-minute playlist for the ride home

Limitations

It uses Yandex Music's private API via the MarshalX/yandex-music-api library; there is no official public API. The first run takes 30-60 seconds while uv resolves dependencies. The token can be invalidated by a password change or session revoke, requiring reissue.

How to disable. Remove the yandex-music block from mcpServers in your client configuration.

MCP

Transport: stdio
Authentication: API key

Environment variables
Environment variables
YANDEX_MUSIC_TOKEN required, secret	Yandex Music token, easiest to get via the Yandex Music Token extension

Security check

The token grants full access to the account's music profile
It creates, fills and removes tracks from the user's playlists

README in short

The README shows a build-free quick start via uv, getting a token with a Chrome extension, connecting to Claude Desktop and Claude Code, a table of 9 tools, a ready prompt for taste analysis and scenario-based playlist creation, a troubleshooting section, and a short Russian summary at the end.

FAQ

Does the project need a build step?

No, it is a single Python file with PEP 723 dependencies; uv installs them on first run.

What is the easiest way to get a token?

The Yandex Music Token Chrome extension: sign in at music.yandex.ru under the right account and copy the token from the extension icon.

HyperFrames

Editors’ pick

Skills and CLI from HeyGen: the agent writes HTML compositions and renders them into MP4 videos, captions, motion graphics and decks

SkillMedium risk53.9K

Blender MCP

MCP for Blender

Editors’ pick

An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender

MCP serverHigh risk29.5K

Remotion Agent Skills

Editors’ pick

Official Remotion skills for making videos in React: compositions, animation, captions, maps and rendering

SkillLow risk4.8K

OpenMontage

Agentic video studio for Claude Code, Cursor and Codex: script, voiceover, images, stock footage, music, subtitles and render

WorkflowMedium risk61.8K

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

HyperFrames

Blender MCP

Remotion Agent Skills

OpenMontage