Xiaomi
xiaomi
This section shows you how to integrate a Xiaomi router or a Xiaomi camera into Home Assistant.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
camera | Camera | Needs its own HomeKit Bridge in accessory mode |
device_tracker | Presence (as an occupancy sensor) |
What people report
Xiaomi Aqara gateway sensors and switches were added early. Newer Xiaomi purifiers needed separate miio support.
- Works3
- Requested1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Aqara motion and magnet sensors | Works | Auto-discovered through Xiaomi Aqara gatewaySaved copyDescription: This PR adds the device support for a few new sensors of the xiaomi aqara gateway (sensor_motion.aq2, sensor_magnet.aq2, ctrl_ln1, ctrl_ln2). The sensors will be auto-discovered and doesn't need configuration. Some minor issues of the recently merged component will be fixed also. Excerpt saved from GitHub on 2026-10-23. | PR #8577 · 2017-07 | |
| Aqara wall switches | Works | Supported through Xiaomi Aqara gatewaySaved copyDescription: This PR adds the device support for a few new sensors of the xiaomi aqara gateway (sensor_motion.aq2, sensor_magnet.aq2, ctrl_ln1, ctrl_ln2). The sensors will be auto-discovered and doesn't need configuration. Some minor issues of the recently merged component will be fixed also. Excerpt saved from GitHub on 2026-10-23. | PR #8577 · 2017-07 | |
| Aqara water leak sensor | Works | Supported via Xiaomi gatewaySaved copyDescription: Pull request in home-assistant.github.io with documentation: https://github.com/home-assistant/home-assistant.github.io/pull/3266 Excerpt saved from GitHub on 2026-10-23. | PR #9172 · 2017-08 | |
| Xiaomi Smart Air Purifier 4 | Requested | LED control and device support missing; 'Unsupported device found' errorSaved copy> How can you add Xiaomi Smart Air Purifier 4 (zhimi.airp.mb5) into Home assistant? I used latest version 2022.09.0, but still cannot connect Error log: ERROR (MainThread) [homeassistant.components.xiaomi_miio] Unsupported device found! Please create an issue at https://github.com/syssi/xiaomi_airpurifier/issues and provide the following data: zhimi.airp.mb5a > > I think it's because of A in the end. I have same model, but (if I not mistaken) there is exist mb5 and your (as well as mine) is mb5a I have same model mb5a. Xiaomi_miio not working this model. I hope next build can support for this … Excerpt saved from GitHub on 2026-10-23. | Issue #77891 · 2022-09 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 117 (0.02%) |
|---|---|
| Quality scale | Legacy |
| Added in | Home Assistant 0.72 |
| Set up in the UI | No, YAML |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
