How do I install the Xiaomi Home skill?

Run npx skillmds add modbender/xiaomi-home in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Xiaomi Home safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Xiaomi Home?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Xiaomi Home free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Xiaomi Home?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Xiaomi Home by modbender — Agent Skill

Name: Xiaomi Home
Rating: 4.2 (5 reviews)
Author: modbender

Xiaomi Home

[English] Control Xiaomi Home devices via local LAN using miiocli. Supports status checks, toggling power, and MIOT property manipulation for devices like smart plugs, humidifiers, and rice cookers. | [中文] 通过局域网利用 miiocli 控制米家智能设备。支持查看状态、开关控制以及对智能插座、加湿器、电饭煲等 MIOT 设备的属性调优。

modbender 8ef18df 4 files · 42.9 KB Updated Sep 9, 2026 12 repo stars

File contents

Xiaomi Home Control 🏠 | 小米家居控制

[English] | 中文

English

Enable code-level control of Xiaomi (Mi Home) devices over the local network.

🚀 Features

Local Network Control: Fast, direct communication without relying on heavy cloud APIs.
Built-in Token Extractor: Includes a script to easily fetch your device IPs and Tokens from Xiaomi Cloud.
Pre-configured Workflows: Ready-to-use commands for smart plugs (e.g., water heaters), humidifiers, and rice cookers.
Automatic Dependency Fix: Solves common library conflicts (like the click version issue) automatically.

🛠️ Setup & Device Inventory

Tokens: Obtain device IPs and Tokens using the bundled script:
```
python3 scripts/token_extractor.py
```
Registry: Store your device details in references/devices.md or references/my_private_devices.md.

🤖 Natural Language Intents

When the user gives a command, map it to the corresponding miiocli operation:

User Intent	Device Type	Action	Technical Command (Example)
"Turn on water heater"	Smart Plug	Power ON	`miiocli miotdevice --ip <IP> --token <TOKEN> raw_command set_properties '[{"siid": 2, "piid": 1, "value": true}]'`
"Turn off water heater"	Smart Plug	Power OFF	`miiocli miotdevice --ip <IP> --token <TOKEN> raw_command set_properties '[{"siid": 2, "piid": 1, "value": false}]'`
"Humidifier to max"	Humidifier	Set Mode	`miiocli miotdevice --ip <IP> --token <TOKEN> set_property_by 2 5 3`
"Is rice cooked?"	Rice Cooker	Check Status	`miiocli cooker --ip <IP> --token <TOKEN> status`

中文说明

实现在局域网内对小米（米家）智能家居设备的代码级直接控制。

🚀 核心特性

本地化控制：直接在局域网内通信，响应极快，不完全依赖复杂的云端 API。
内置 Token 提取器：自带提取脚本，轻松从小米账号同步所有设备的 IP 和 32 位 Token 密钥。
预设工作流：支持智能插座（如热水器控制）、加湿器、米家小饭煲等多种常见设备。
自动环境优化：安装时自动处理 Python 依赖冲突（如 click 版本问题），确保开箱即用。

🛠️ 快速开始

获取钥匙：运行内置的提取脚本：
```
python3 scripts/token_extractor.py
```
配置列表：将您的设备信息填入 references/devices.md。
下达指令：对着机器人喊：“打开热水器”或“查看加湿器状态”。

🔗 Links | 相关链接

ClawdHub: https://www.clawhub.ai/s/xiaomi-home
GitHub: https://github.com/Pegasus02/clawdbot-xiaomi-home

Developed with 🦞 by @Pegasus02

---name: xiaomi-homedescription: [English] Control Xiaomi Home devices via local LAN using miiocli. Supports status checks, toggling power, and MIOT property manipulation for devices like smart plugs, humidifiers, and rice cookers. | [中文] 通过局域网利用 miiocli 控制米家智能设备。支持查看状态、开关控制以及对智能插座、加湿器、电饭煲等 MIOT 设备的属性调优。--- # Xiaomi Home Control 🏠 | 小米家居控制 [English] | [中文](#中文说明) --- ## English Enable code-level control of Xiaomi (Mi Home) devices over the local network. ### 🚀 Features - **Local Network Control**: Fast, direct communication without relying on heavy cloud APIs. - **Built-in Token Extractor**: Includes a script to easily fetch your device IPs and Tokens from Xiaomi Cloud. - **Pre-configured Workflows**: Ready-to-use commands for smart plugs (e.g., water heaters), humidifiers, and rice cookers. - **Automatic Dependency Fix**: Solves common library conflicts (like the `click` version issue) automatically. ### 🛠️ Setup & Device Inventory 1. **Tokens**: Obtain device IPs and Tokens using the bundled script: ```bash python3 scripts/token_extractor.py ``` 2. **Registry**: Store your device details in `references/devices.md` or `references/my_private_devices.md`. ## 🤖 Natural Language Intents When the user gives a command, map it to the corresponding `miiocli` operation: | User Intent | Device Type | Action | Technical Command (Example) | | :--- | :--- | :--- | :--- | | "Turn on water heater" | Smart Plug | Power ON | `miiocli miotdevice --ip <IP> --token <TOKEN> raw_command set_properties '[{"siid": 2, "piid": 1, "value": true}]'` | | "Turn off water heater" | Smart Plug | Power OFF | `miiocli miotdevice --ip <IP> --token <TOKEN> raw_command set_properties '[{"siid": 2, "piid": 1, "value": false}]'` | | "Humidifier to max" | Humidifier | Set Mode | `miiocli miotdevice --ip <IP> --token <TOKEN> set_property_by 2 5 3` | | "Is rice cooked?" | Rice Cooker | Check Status | `miiocli cooker --ip <IP> --token <TOKEN> status` | --- ## 中文说明实现在局域网内对小米（米家）智能家居设备的代码级直接控制。 ### 🚀 核心特性 - **本地化控制**：直接在局域网内通信，响应极快，不完全依赖复杂的云端 API。 - **内置 Token 提取器**：自带提取脚本，轻松从小米账号同步所有设备的 IP 和 32 位 Token 密钥。 - **预设工作流**：支持智能插座（如热水器控制）、加湿器、米家小饭煲等多种常见设备。 - **自动环境优化**：安装时自动处理 Python 依赖冲突（如 `click` 版本问题），确保开箱即用。 ### 🛠️ 快速开始 1. **获取钥匙**：运行内置的提取脚本： ```bash python3 scripts/token_extractor.py ``` 2. **配置列表**：将您的设备信息填入 `references/devices.md`。 3. **下达指令**：对着机器人喊：“打开热水器”或“查看加湿器状态”。 --- ## 🔗 Links | 相关链接 - **ClawdHub**: [https://www.clawhub.ai/s/xiaomi-home](https://www.clawhub.ai/s/xiaomi-home) - **GitHub**: [https://github.com/Pegasus02/clawdbot-xiaomi-home](https://github.com/Pegasus02/clawdbot-xiaomi-home) Developed with 🦞 by **@Pegasus02**

Frequently asked questions