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
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
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/yandex-music-mcp-server-unofficialDetects 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-mcpOr 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.
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.
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-mcpOr 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.
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-mcpNo-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 itLimitations
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 | |
|---|---|
| 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.
Related
Skills and CLI from HeyGen: the agent writes HTML compositions and renders them into MP4 videos, captions, motion graphics and decks
Blender MCP
MCP for Blender
An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender
Official Remotion skills for making videos in React: compositions, animation, captions, maps and rendering
Agentic video studio for Claude Code, Cursor and Codex: script, voiceover, images, stock footage, music, subtitles and render