App Store Production: https://homey.app/a/com.xiaomi-miio
App Store Test: https://homey.app/a/com.xiaomi-miio/test
About the app
Use Homey to control supported Wi-Fi devices that are normally managed through the Xiaomi Mi Home app.
The app can also control supported Xiaomi and Aqara Zigbee devices connected through a compatible Xiaomi Mi Home Gateway. You can use multiple gateways and distribute your Zigbee devices between them; the app itself does not impose a fixed limit on the number of connected Zigbee devices.
If you want to connect Zigbee devices directly to Homey without using a Xiaomi gateway, use the separate Xiaomi Zigbee app available in the Homey App Store.
A list of devices currently supported by this app is available here:
Important information
Xiaomi does not officially support controlling these devices outside the Mi Home ecosystem. Pairing therefore requires additional steps and, in some cases, a certain level of technical knowledge.
If device support LAN/Local MioT, it must be on the same VLAN as Homey
Please also keep in mind that:
- Not every Xiaomi ecosystem device is supported.
- Devices that look identical may use different model IDs or protocols.
- Regional variants, such as EU and CN models, may behave differently.
- Xiaomi may change its devices, firmware, cloud services or ecosystem at any time.
- Such changes may temporarily or permanently prevent Homey from communicating with a device.
Is an existing device no longer working?
For general help and troubleshooting, first post your question in this Homey Community topic.
Please describe the issue in English and include as much relevant information as possible:
- Confirmation the device is on the same VLAN and subnet, as Homey
- The exact product name
- The device model ID, for example
zhimi.airpurifier.mc1 - The product variant or region, such as EU or CN
- The installed app version
- The Homey model and Homey firmware version
- Whether the device previously worked
- Any relevant error message
- The steps needed to reproduce the problem
Please also send a diagnostic report from within the Xiaomi Mi Home app on Homey and include the diagnostic report ID in your post.
If the problem has been identified as an app bug and can be reproduced, you may create a GitHub issue here:
Before opening a new issue, please check whether the same problem has already been reported.
Pairing miIO devices
For Homey to communicate with a device through the miIO protocol, the device’s unique token is usually required. Retrieving this token may require additional tools and technical knowledge.
Token retrieval instructions:
Video instructions:
To determine which Homey driver should be used for your device, consult the supported-device list:
Whenever possible, give the Xiaomi device a fixed IP address or DHCP reservation. This helps prevent communication problems if its IP address changes.
Requesting support for a new device
Not every Xiaomi ecosystem device can be supported automatically. Before requesting support, check whether the device is already listed:
Support for a new device normally requires at least one of the following:
- An existing open-source implementation or library that documents the device’s miIO methods and properties.
- Technical information supplied by a user who owns the device, including its exact model ID and the methods, properties and values used by the device. This information can often be obtained by inspecting or capturing communication between the device and the Mi Home app. Further information is available in the python-miio contribution guide.
- Physical access to the device for development and testing. This generally means that a user would need to provide or send the device to the developer.
Without access to the protocol information or the physical device, adding support is usually not possible.
Requests for new-device support can be submitted here:
When submitting a request, always include:
- The exact product name
- A link to the exact product variant
- The complete model ID, for example
roborock.vacuum.a15 - The region or variant, such as EU or CN
- Any known miIO methods and properties
- Links to an existing implementation in another open-source project, if available
Please do not submit only a marketing name or product photograph. Xiaomi frequently sells visually similar products with different model IDs and protocols.
Support the development
Community apps and appreciation
These Homey Community apps are developed and maintained in my spare time.
Did you know? In my experience maintaining community Homey apps, only a very small proportion of users choose to support their development financially—even when a new device integration or specific feature has been implemented at their request.
Contributions are never required, but they are a meaningful way to recognise the time invested in development, testing, compatibility updates and ongoing user support. If one of my apps has been useful to you, you can optionally show your appreciation here:
Send an optional thank-you via PayPal
A contribution does not unlock additional features or affect the support you receive. It is simply a way to say thank you.
My Homey apps
 Smart Presence Wi-Fi presence detection |
 Xiaomi Mi Home Xiaomi Mi Home devices |
 Broadlink IR, RF and smart devices |
|||
 TP-Link KASA LAN Local Kasa control |
 Yeelights LAN Local Yeelight control |
 Xiaomi Miija Temperature and humidity sensors |
|||
 Octoprint Monitor your 3D printer |
 Virtual Radar ADS-B aircraft tracking |
 enigma2 Control Enigma2 receivers |
