yandex-iot-mcp
MCP (Model Context Protocol) server for the Yandex Smart Home IoT API (API reference). Lets AI assistants (Claude Code, Claude Desktop, and any other MCP client) inspect and control devices connected to Yandex Smart Home / Alice.
Tools
| Tool | Description |
|---|---|
list_devices |
All devices with rooms, types, capabilities and sensor values |
list_groups |
Device groups from the Yandex Home app |
get_device |
Full state of one device, including online/offline |
turn_on / turn_off |
On/off for sockets, lights, switches |
power_cycle |
Off → wait N seconds → on. Hard-reset gear plugged into a smart socket |
device_action |
Any capability action (range, mode, toggle, color_setting…) |
list_scenarios / run_scenario |
Inspect and trigger scenarios |
Getting an OAuth token
- Create an app at oauth.yandex.ru: platform
Web services, redirect URI
https://oauth.yandex.ru/verification_code. - Grant it the iot:view and iot:control permissions ("Умный дом").
- Open
https://oauth.yandex.ru/authorize?response_type=token&client_id=<CLIENT_ID>in a browser, authorize, and copyaccess_tokenfrom the address bar.
Usage
Claude Code
claude mcp add yandex-iot --env YANDEX_IOT_TOKEN=<token> -- uvx yandex-iot-mcp
Claude Desktop
{
"mcpServers": {
"yandex-iot": {
"command": "uvx",
"args": ["yandex-iot-mcp"],
"env": { "YANDEX_IOT_TOKEN": "<token>" }
}
}
}
Example
"The server is frozen again — power-cycle the socket it's plugged into."
The assistant finds the socket via list_devices and calls
power_cycle(device_id, off_seconds=10).
From source
uvx --from git+https://github.com/ssubbotin/yandex-iot-mcp yandex-iot-mcp
Development
uv sync
uv run pytest
YANDEX_IOT_TOKEN=<token> uv run yandex-iot-mcp
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for yandex-iot-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yandex_iot_mcp-0.1.1.tar.gz | 7.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yandex_iot_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.0 kB
Release files / yandex_iot_mcp-0.1.1.tar.gz
| Download URL | yandex_iot_mcp-0.1.1.tar.gz |
|---|---|
| Size | 7.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1927e2ec0bb1156f6329be449a6b8ae06eb32709f330fa0d4eb13cf5fc0b6397
|
|
BLAKE2b-256 checksum How to use checksums |
e62b61e580ba8246651ba3d0dd22dfdfb2b6e56e285bb87524a1bfccc870e8d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / yandex_iot_mcp-0.1.1-py3-none-any.whl
| Download URL | yandex_iot_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 6.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
48004cdd02a171f0b65d23d6bc539f19a62a6fd4f68b817940e2aaea185ef61e
|
|
BLAKE2b-256 checksum How to use checksums |
5929660e767609ba42444cfbe9425b42b0a3294e40bc6e55a5bbbaeabdb3c754
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
