Yandex Music MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YANDEX_MUSIC_TOKEN | No | Yandex Music OAuth token (optional; by default read from ~/.yandex-music-mcp/token created by yandex-music-mcp-auth) | |
| YANDEX_MUSIC_EXPORT_DIR | No | Folder for .txt/.csv exports (default: Documents/Yandex Music exports) | |
| YANDEX_MUSIC_TOKEN_FILE | No | Path to the token file, if not in the default location |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| account_infoA | Проверка подключения: логин, имя и статус подписки Плюс. |
| searchB | Поиск по каталогу Яндекс Музыки. type сужает поиск; limit — сколько результатов в каждой категории. |
| get_liked_tracksA | Треки из «Мне нравится», от последних лайков к старым. Для анализа вкуса бери limit побольше (до 500). |
| get_listening_historyB | Недавно прослушанные треки (история прослушиваний), сгруппированные по дням. |
| list_my_playlistsA | Все мои плейлисты (kind — идентификатор плейлиста для других инструментов). |
| get_playlist_tracksB | Треки плейлиста. По умолчанию — мой плейлист; owner_uid — для чужого публичного. |
| get_album_tracksC | Информация об альбоме и его треклист. |
| get_playlist_by_urlA | Треки по ссылке на Яндекс Музыку — в том числе чужого публичного плейлиста. Понимает ссылки вида music.yandex.ru/users/<логин>/playlists/<номер>, music.yandex.ru/playlists/ (новый формат, в т.ч. lk.…) и ссылки на альбом /album/. Подходит любой домен Яндекс Музыки (.ru, .com, .by, .kz и т.д.). |
| get_artist_tracksC | Популярные треки артиста. |
| get_similar_tracksB | Похожие треки по версии Яндекса (track_id в формате "123" или "123:456"). |
| get_my_waveA | Порция треков из «Моей волны» — персональных рекомендаций. batches — сколько порций (≈5 треков каждая). |
| get_chartC | Текущий чарт Яндекс Музыки. |
| export_tracks_to_fileA | Выгружает ВСЕ треки (лайки или плейлист) в текстовые файлы на компьютер, не загружая их в чат: .txt («Исполнитель — Название», по строке) и .csv (с альбомом, годом, жанром, id). Файлы кладутся в «Документы/Yandex Music exports» (или в YANDEX_MUSIC_EXPORT_DIR). Для source="playlist" нужен kind. |
| create_playlistB | Создаёт новый плейлист (по умолчанию приватный). Возвращает его kind. |
| add_tracks_to_playlistC | Добавляет треки в мой плейлист. track_ids — id из других инструментов ("123:456" или "123"). |
| remove_tracks_from_playlistC | Удаляет указанные треки из моего плейлиста. |
| delete_playlistA | НЕОБРАТИМО удаляет мой плейлист целиком. Перед вызовом обязательно спроси пользователя. confirm_title — точное название удаляемого плейлиста (защита от удаления не того плейлиста). |
| like_tracksC | Ставит лайк («Мне нравится») трекам. |
| unlike_tracksC | Убирает треки из «Мне нравится». |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Most tools have distinct resource+action targets. There is minor overlap between get_playlist_tracks and get_playlist_by_url (both return playlist tracks via different identifiers) and between get_liked_tracks and export_tracks_to_file, but descriptions clarify their separate purposes.
The set strongly follows a verb_noun snake_case pattern (get_liked_tracks, create_playlist, add_tracks_to_playlist, delete_playlist). Only account_info (noun-only) and search (verb-only) deviate slightly, which is still readable.
19 tools is slightly heavy but well justified for a music service covering catalog, playlists, likes, recommendations, and export. Each tool earns its place with little redundancy.
Full lifecycle coverage of likes (like/unlike), playlists (list/get/create/add/remove/delete), plus search, album, artist, chart, history, recommendations, and export. Minor gaps like playlist metadata editing or track detail lookup are workable.