Yandex Station MCP

An MCP server and Codex skill to control a Yandex Station: music, radio, volume, text commands to Alice, smart home scenarios

  • 3 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • Controls a real device at home and triggers smart home scenarios
  • Stores a Yandex account access token locally in a JSON file
All reasons and checks
Russian stack

yasg1988/yandex-station-mcp

Install

Services

Manual install

git clone https://github.com/yasg1988/yandex-station-mcp.git
cd yandex-station-mcp
python -m venv .venv
pip install -r requirements.txt

Installing dependencies before first authorization.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Controls a real device at home and triggers smart home scenarios
  • Stores a Yandex account access token locally in a JSON file

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

What it does

The server uses an unofficial Yandex Station protocol modeled on the AlexxIT/YandexStation project and gives an agent the account's speaker list, text commands to Alice, speaking text and notifications at a chosen volume, playback and volume control, timers, alarms, reminders, weather and news, and running Yandex Smart Home scenarios. Authorization goes through a Yandex QR code, and tokens are saved locally to a JSON file. For cloud control the server creates or updates a service scenario in the account named like HA <device_id>.

Who it is for. For people who want to control a Yandex Station from Claude, Codex or another MCP agent: music, timers, and smart home scenarios.

Good fit when

  • You want to control an Alice speaker with voice-like commands from a text agent
  • You need timers, alarms, weather and news via the Station without opening the app
  • You need to trigger existing Yandex Smart Home scenarios from an agent

Not a fit when

  • You need an official, stable Yandex API: this is an unofficial protocol that can change at any time
  • You are not willing to go through Yandex QR authorization and store a token locally

Example request

Turn on Europa Plus radio on the speaker and set the volume to 40 percent

MCP

Transport
stdio
Authentication
OAuth

Environment variables

YANDEX_TOKEN_FILE required, secret
Path to the local token file after QR authorization.
YANDEX_STATION_ID
Default speaker ID when there are several.

Limitations

This is an unofficial Yandex API based on reverse engineering, and it can break when Yandex changes something on its side. Tokens are stored only locally in yandex_tokens.json and must not end up in public repos. Cloud mode does not always know exactly what is playing, though it sends commands reliably. Cloud control creates a service scenario in the account named like HA <device_id>.

How to disable. Remove the yandex-station server from your MCP client config, delete the yandex_tokens.json file, and remove the HA <device_id> service scenario in the Yandex app with Alice.

FAQ

Is this an official Yandex API?

No, the README explicitly calls it unofficial and based on approaches from the AlexxIT/YandexStation project.

How does authorization work?

Via a QR code: the auth_qr.py script shows a link, and after signing in to Yandex a local token file is created.

Discussion

No questions or reviews yet.

Russian stack

MCP server for Yandex Smart Home with Alice: list devices, switch them on and off, power-cycle sockets and run scenarios

MCP serverBroad access
Russian stack

A skill speaks text on a Yandex Station in Alice's voice over the Glagol protocol: pauses music, raises volume to 80%, restores it cleanly

SkillMinimal access2Repository stars

Yandex Station TTS skill

claude-skill-yandex-tts

Russian stack

A Claude Code skill that speaks answers in Alice's voice on a Yandex Station over the local network

SkillBroad access1Repository stars
Russian stack

Claude Code skill for evaluating websites by Yandex EPOS criteria (expertise, usefulness, originality, content richness) and visibility in Alice AI

SkillMinimal access3Repository stars

Yandex Smart Home for OpenClaw

Yandex Smart Home CLI for OpenClaw

Russian stack

Python CLI and OpenClaw skill to switch Yandex Smart Home lights and sockets and set brightness, color temperature and color

SkillExtended access
Russian stack

Fifteen Claude Code plugins for Yandex services sharing one OAuth token: Metrica, Webmaster, Wordstat, Direct, Disk, Tracker and more

PluginBroad access4Repository stars

README in short

The README lists the server's capabilities: speaker list, text commands, volume-aware TTS, playback control, timers, alarms, weather, news and smart home scenarios, honestly calls the protocol unofficial, and warns about token storage. It gives a venv and requirements.txt install, QR authorization, verification via a station list and a command, and a Codex connection example through config.toml.

README badge

Report a problem