Yandex Music playlist creation MCP server

Yandex Music MCP Server (unofficial)

A minimal MCP server for creating Yandex Music playlists: search tracks and add them to a playlist

MCP server

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • The token grants full access to the account's music profile
  • The token method technically violates Yandex Music's terms of use
All reasons and checks
Russian stack

lappi/yandex-music-mcp

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/yandex-music-mcp-server-unofficial

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 --from git+https://github.com/lappi/yandex-music-mcp yandex-music-mcp

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

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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":["--from","git+https://github.com/lappi/yandex-music-mcp","yandex-music-mcp"],"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": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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 --from git+https://github.com/lappi/yandex-music-mcp yandex-music-mcp

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

[mcp_servers.yandex-music]
command = "uvx"
args = ["--from", "git+https://github.com/lappi/yandex-music-mcp", "yandex-music-mcp"]
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.

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

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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",
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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": [
        "--from",
        "git+https://github.com/lappi/yandex-music-mcp",
        "yandex-music-mcp"
      ],
      "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 a055533.

Text for your agent

Get a token with uvx --from git+https://github.com/lappi/yandex-music-mcp yandex-music-mcp-token, then connect the server with claude mcp add yandex-music --env YANDEX_MUSIC_TOKEN=token -- uvx --from git+https://github.com/lappi/yandex-music-mcp yandex-music-mcp.

Other ways from the author
claude mcp add yandex-music --env YANDEX_MUSIC_TOKEN=<token> -- uvx --from git+https://github.com/lappi/yandex-music-mcp yandex-music-mcp

No-install run via uvx, requires a token obtained beforehand.

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

What it does

A thin wrapper over the yandex-music-api library with three tools: create a playlist with a title and visibility, search tracks by free-text query, and add found tracks to a playlist. The server only speaks stdio. A separate console command ships alongside it for getting a token via OAuth device flow: it prints a link and code, the user confirms sign-in in a browser, and the token appears in the command's output.

Who it is for. For those who want the simplest scenario: build a playlist from found tracks through an agent, with nothing extra.

Good fit when

  • You only need search plus playlist creation, no likes reading or analytics
  • You want a no-install run via uvx straight from git
  • You want a built-in helper for getting a token via device flow

Not a fit when

  • You need to read likes, genres or the user's playlists: not available here
  • Strict ToS compliance matters: the token method uses the mobile app's client_id, which technically violates the terms

Example request

Create a playlist 'Classic Rock' and add 5 Queen tracks to it

Limitations

Only three tools; no reading of likes, playlists or similar tracks. The package is not published to PyPI, so the uvx command needs the --from flag pointing at the repo. The device-flow token method uses the publicly known client_id and client_secret of the Yandex Music mobile app; the author explicitly warns this violates the terms of use and offers alternative token sources at your own risk.

How to disable. Remove the yandex-music entry from your MCP client configuration.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
YANDEX_MUSIC_TOKEN
required, secret
Yandex Music token, obtainable via the bundled device-flow command

Security check

  • The token grants full access to the account's music profile
  • The token method technically violates Yandex Music's terms of use

README in short

The README lists the three tools, shows a no-install uvx run and a pip install path, explains getting a token via device flow with an explicit ToS-violation warning, gives configs for Claude Code and Claude Desktop across OSes, and a debug command via MCP Inspector.

FAQ

Do I need to install it ahead of time?

No, uvx --from git+... downloads and runs the server on the fly if uv is installed.

Is the token method allowed?

The author states outright that the device flow uses the mobile app's client_id and technically violates the ToS; use is at your own risk.

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.9KRepository stars

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.5KRepository stars
Editors’ pick

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

SkillLow risk4.8KRepository stars

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

WorkflowMedium risk61.8KRepository stars
Foxx AIYandex Music playlist creation MCP server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.