finds.dev

XiaoMi/ha_xiaomi_home

Xiaomi Home Integration for Home Assistant

View on GitHub

★ 21,768PythonNOASSERTIONupdated Jan 2026

// the take

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.

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
21,768
Forks
1,156
Language
Python
License
NOASSERTION
Last commit
28 Jan 2026

// nearby

If ha_xiaomi_home isn't quite it.

All repos →