MCP.Market

Yandex Music (unofficial) MCP server

by kenzolika·io.github.kenzolika/yandex-music-mcp·v0.2.1·1 stars
No reviews yet

Unofficial Yandex Music server: search, likes, history, My Wave, playlists. Token stays local.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

1 stars48 downloads/wk

Reviews

Write one

Nobody has reviewed Yandex Music (unofficial) yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Yandex Music (unofficial) tools (19, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • account_info

    Проверка подключения: логин, имя и статус подписки Плюс.

  • add_tracks_to_playlist

    Добавляет треки в мой плейлист. track_ids — id из других инструментов ("123:456" или "123").

  • create_playlistwrite action

    Создаёт новый плейлист (по умолчанию приватный). Возвращает его kind.

  • delete_playlistwrite action

    НЕОБРАТИМО удаляет мой плейлист целиком. Перед вызовом обязательно спроси пользователя. confirm_title — точное название удаляемого плейлиста (защита от удаления не того плейлиста).

  • export_tracks_to_file

    Выгружает ВСЕ треки (лайки или плейлист) в текстовые файлы на компьютер, не загружая их в чат: .txt («Исполнитель — Название», по строке) и .csv (с альбомом, годом, жанром, id; для лайков — дата лайка). Файлы кладутся в «Документы/Yandex Music exports» (или в YANDEX_MUSIC_EXPORT_DIR). Для source="playlist" нужен kind.

  • get_album_tracks

    Информация об альбоме и его треклист.

  • get_artist_tracks

    Популярные треки артиста.

  • get_chart

    Текущий чарт Яндекс Музыки.

  • get_liked_tracks

    Треки из «Мне нравится», от последних лайков к старым, с датой лайка (liked_at). Для анализа вкуса бери limit побольше (до 500).

  • get_listening_history

    Недавно прослушанные треки (история прослушиваний), сгруппированные по дням.

  • get_my_wave

    Порция треков из «Моей волны» — персональных рекомендаций. batches — сколько порций (≈5 треков каждая).

  • get_playlist_by_url

    Треки по ссылке на Яндекс Музыку — в том числе чужого публичного плейлиста. Понимает ссылки вида music.yandex.ru/users/<логин>/playlists/<номер>, music.yandex.ru/playlists/<uuid> (новый формат, в т.ч. lk.…) и ссылки на альбом /album/<id>. Подходит любой домен Яндекс Музыки (.ru, .com, .by, .kz и т.д.).

  • get_playlist_tracks

    Треки плейлиста. По умолчанию — мой плейлист; owner_uid — для чужого публичного.

  • get_similar_tracks

    Похожие треки по версии Яндекса (track_id в формате "123" или "123:456").

  • like_tracks

    Ставит лайк («Мне нравится») трекам.

  • list_my_playlists

    Все мои плейлисты (kind — идентификатор плейлиста для других инструментов).

  • remove_tracks_from_playlistwrite action

    Удаляет указанные треки из моего плейлиста.

  • search

    Поиск по каталогу Яндекс Музыки. type сужает поиск; limit — сколько результатов в каждой категории.

  • unlike_tracks

    Убирает треки из «Мне нравится».

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 9 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Yandex Music (unofficial) compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 70% of 3,470 Web search servers
Tools
19
the typical Web search server has 5
Tools that change things
16%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 55% of 1,786 Web search servers
Downloads a week
48
more than 33% of 827 Web search servers with a package

What its tools let an agent do: 15 read · 2 create · 2 delete

Install Yandex Music (unofficial) in Claude Code, Cursor or VS Code

claude mcp add yandex-music-mcp -- uvx yandex-music-mcp
Add to Cursor

What the publisher says

From the Yandex Music (unofficial) repository's README, as published. We do not edit it. Read it on GitHub

yandex-music-mcp

<!-- mcp-name: io.github.kenzolika/yandex-music-mcp -->

Неофициальный MCP-сервер для Яндекс Музыки. Подключается к Claude Desktop, Claude Code и другим MCP-клиентам и даёт ассистенту доступ к вашей библиотеке: лайкам, истории прослушиваний, «Моей волне» и плейлистам.

Сервер работает локально на вашем компьютере (stdio). Токен хранится только у вас и никуда не передаётся. Поддерживаются Windows, macOS и Linux.

⚠️ Неофициальный проект. Не связан с ООО «Яндекс» и не одобрен им. Использует неофициальную библиотеку yandex-music: если Яндекс изменит API, сервер может временно перестать работать. Аудио сервер не скачивает — только работает с метаданными, лайками и плейлистами вашего аккаунта.

English version below ↓

Что умеет

Воспроизведением сервер не управляет: музыку вы слушаете, как обычно, в приложении Яндекс Музыки, а новые плейлисты и лайки появляются там сразу.

Примеры запросов

  • «Проанализируй мои последние 300 лайков: какие жанры и десятилетия я слушаю?»
  • «Что я слушал на этой неделе?»
  • «Собери приватный плейлист "Осень" из 25 треков, похожих на мои последние лайки»
  • «Вот плейлист друга: <ссылка>. Что из него уже есть в моих лайках?»
  • «Выгрузи все мои лайки в файл»

Быстрая установка

1. Установите uv — он скачает и запустит коннектор:

  • Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh

Закройте терминал, откройте заново и проверьте: uv --version.

2. Войдите в Яндекс (один раз):

uvx --from yandex-music-mcp yandex-music-mcp-auth

3. Подключите к клиенту:

  • Claude Code — одна команда:
claude mcp add yandex-music -- uvx yandex-music-mcp
  • Claude Desktop — откройте Settings → Developer → Edit Config и добавьте в файл claudedesktopconfig.json:
{
    "mcpServers": {
      "yandex-music": {
        "command": "uvx",
        "args": ["yandex-music-mcp"]
      }
    }
  }

Если что-то не получилось, ниже — пошаговая установка из исходников с подробностями.

Установка из исходников

Понадобятся uv и аккаунт Яндекса. Для части функций (например, «Моей волны») может понадобиться подписка Плюс.

1. Установите uv

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Закройте терминал, откройте заново и проверьте: uv --version.

2. Скачайте проект

git clone https://github.com/kenzolika/yandex-music-mcp.git

Или нажмите Code → Download ZIP на странице репозитория и распакуйте архив.

3. Получите токен (один раз)

cd yandex-music-mcp
uv run yandex-music-mcp-auth

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Yandex Music (unofficial): common questions

Is Yandex Music (unofficial) MCP server safe?
Mostly: it is graded B (83/100). Read the Yandex Music (unofficial) safety report
How do I install Yandex Music (unofficial)?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Yandex Music (unofficial) need an API key?
Yes. The registry entry asks for YANDEX_MUSIC_TOKEN.
Is Yandex Music (unofficial) maintained?
The last commit was 30 days ago (2026-10-05). The latest release is v0.2.1.
What can I use instead of Yandex Music (unofficial)?
Servers from other publishers that do the same job: Alza MCP server, Chatroost — unofficial Telegram MCP server and Ref Tools MCP server.
How does Yandex Music (unofficial) compare with other Web search MCP servers?
safety score 83/100 (higher than 70% of 3,470 Web search servers); tools 19 (the typical Web search server has 5); tools that change things 16% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Yandex Music (unofficial)

Same job from other publishers: the closest match first, then the best rated.

  • Alza
    Unofficial MCP server for Alza.cz: catalog search plus token-guarded account and checkout.
    B
  • Chatroost — unofficial Telegram MCP server
    Unofficial Telegram MCP server — read, search, reply and react in your own Telegram account.
    A
  • Ref Tools
    Token-efficient search for coding agents over public and private documentation.
    A
  • Crg
    Token-efficient code review knowledge graph: semantic search and call-graph resolution.
    B
  • MCP Zotero
    Unofficial Zotero server: search your library, add papers by DOI, import PDFs, cite in Word
    B