Repolode
Submit
XiaoMi

XiaoMi/ha_xiaomi_home

Official Xiaomi integration that brings Xiaomi IoT smart devices into Home Assistant via Xiaomi Cloud or a local central hub gateway.

Open-source alternative to:Mi Home

View on GitHub
Stars
22,240
Forks
1,193
Open issues
157
Last commit
26 days ago

What is it?

Xiaomi Home Integration is a custom component for Home Assistant, maintained by Xiaomi, that imports Xiaomi IoT devices into Home Assistant. Users sign in with their Xiaomi account using OAuth 2.0, choose a home, and the devices in it are created as Home Assistant entities.

Devices are mapped from the MIoT-Spec-V2 specification. Writable properties become Switch, Number, Select or Text entities, read-only properties become Sensor entities, events become Event entities, and actions become Button or Notify entities. Entity conversion rules can be customized with local spec filter and multi-language files. Multiple Xiaomi accounts can be added to one Home Assistant instance.

Control normally goes through Xiaomi Cloud. Where a Xiaomi central hub gateway or a device with a built-in hub is present, commands and state updates can run locally over MQTT. A LAN control option covers some IP-connected devices, although the project recommends against using it.

Key features

  • 01Imports Xiaomi IoT devices into Home Assistant after Xiaomi account login
  • 02Maps MIoT-Spec-V2 properties, events and actions to Home Assistant entities
  • 03Supports local control through Xiaomi central hub gateway or devices with a built-in hub
  • 04Allows multiple Xiaomi accounts and regions in one instance
  • 05Offers 13 interface languages and customizable entity conversion rules

Use cases

  • Controlling Xiaomi lights, plugs and sensors from a Home Assistant dashboard
  • Building automations that combine Xiaomi devices with other smart home brands
  • Running local-first control with a Xiaomi central hub gateway in mainland China

Topics

#home-assistant#smart-home#iot#xiaomi#miot#home-automation#home-assistant-integration#miot-devices#xiaomi-smart-home

FAQ

What is ha_xiaomi_home?
Official Xiaomi integration that brings Xiaomi IoT smart devices into Home Assistant via Xiaomi Cloud or a local central hub gateway. Xiaomi Home Integration is a custom component for Home Assistant, maintained by Xiaomi, that imports Xiaomi IoT devices into Home Assistant. Users sign in with their Xiaomi account using OAuth 2.0, choose a home, and the devices in it are created as Home Assistant entities.
Is ha_xiaomi_home free to use? What license does it have?
ha_xiaomi_home is open source under the Other license. Check the license terms before using it in commercial products.
Is ha_xiaomi_home still maintained?
Actively maintained. The last commit to ha_xiaomi_home was on Sep 28, 2026.
What can I use ha_xiaomi_home for?
Controlling Xiaomi lights, plugs and sensors from a Home Assistant dashboard Building automations that combine Xiaomi devices with other smart home brands Running local-first control with a Xiaomi central hub gateway in mainland China
Where can I get ha_xiaomi_home?
The source code and installation instructions are on GitHub: https://github.com/XiaoMi/ha_xiaomi_home

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects