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
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
Install
- Works in
- 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.txtInstalling dependencies before first authorization.
Access and checks
How we reviewExtended 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 percentMCP
- Transport
- stdio
- Authentication
- OAuth
Environment variables
YANDEX_TOKEN_FILErequired, 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.
Related
All Alice toolsMCP server for Yandex Smart Home with Alice: list devices, switch them on and off, power-cycle sockets and run scenarios
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
Yandex Station TTS skill
claude-skill-yandex-tts
A Claude Code skill that speaks answers in Alice's voice on a Yandex Station over the local network
Claude Code skill for evaluating websites by Yandex EPOS criteria (expertise, usefulness, originality, content richness) and visibility in Alice AI
Yandex Smart Home for OpenClaw
Yandex Smart Home CLI for OpenClaw
Python CLI and OpenClaw skill to switch Yandex Smart Home lights and sockets and set brightness, color temperature and color
Yandex ecosystem plugin marketplace
claude-yandex-skills
Fifteen Claude Code plugins for Yandex services sharing one OAuth token: Metrica, Webmaster, Wordstat, Direct, Disk, Tracker and more
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.