// the find
XiaoMi/ha_xiaomi_home
Xiaomi Home Integration for Home Assistant
Official Xiaomi integration for Home Assistant, built on MIoT-Spec-V2. Covers most WiFi/Zigbee/BLE-Mesh Xiaomi devices via cloud MQTT subscription, with optional local control through a Xiaomi Central Hub Gateway. If you own a lot of Xiaomi hardware and want it in Home Assistant without reverse engineering anything, this is the official path.
MQTT subscription model means state updates are push-based, not polled — no 10-second lag when you flip a switch. The MIoT-Spec-V2 to HA entity mapping is systematic and well-documented, so adding device support is a data change in YAML/JSON rather than a code change. Local control via Central Hub Gateway is a real local path, not marketing — it runs a full MQTT broker locally. Multiple Xiaomi account support with devices from different accounts merged into one HA area is genuinely useful for households with shared devices.
Local mode requires purchasing a specific Xiaomi Central Hub Gateway and only works in mainland China — everyone else is cloud-dependent with no fallback. OAuth tokens and device certificates are stored in cleartext in the HA config file, which the README admits but can't fix due to HA platform constraints — a stolen config backup is a full account compromise. LAN control (the non-gateway local option) is explicitly described as potentially causing 'abnormalities' and the docs recommend not using it, which is not confidence-inspiring. Bluetooth, infrared, and virtual devices are outright unsupported, so mixed Xiaomi ecosystems will still need other integrations.