Back to the overview

Xiaomi Home in Home Assistant

xiaomi_miio part of Home Assistant since 0.51

Local, polling Set up in the user interface

Xiaomi Home is an official Home Assistant integration for Alarm, Fan, Health, Hub, Light, Presence detection, Remote and Vacuum. Talks to the device on your own network and asks for changes at regular intervals.

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, polling – Talks to the device on your own network and asks for changes at regular intervals.
Setup
in the user interface
Kind
Hub – several devices through one gateway or account
Installations
11,802 (1.7 % of the installations that share statistics)
Categories
Alarm, Fan, Health, Hub, Light, Presence detection, Remote, Vacuum
Provides
Air quality, Alarm control panel, Binary sensor, Button, Device tracker, Diagnostics, Fan, Humidifier, Light, Number, Remote, Select, Sensor, Switch, Vacuum
Found automatically via
Network discovery (Zeroconf)
Maintained by
@rytilahti, @syssi, @starkillerOG
Python packages
construct==2.10.68, micloud==0.5, python-miio==0.5.12

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for Xiaomi Home.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Known issues and fixes

13 open issues and 2 bug fixes in the last twelve months are recorded for Xiaomi Home in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.6.4.

Open

  • open Reported problem #147122 since June 19, 2025 · 172 reactions · 348 comments · #147122
  • open Reported problem #159936 since December 29, 2025 · 3 reactions · 8 comments · #159936
  • open Reported problem #73496 since June 14, 2022 · 2 reactions · 54 comments · #73496
  • open Reported problem #153724 since October 5, 2025 · 1 reaction · 12 comments · #153724
  • open Reported problem #130088 since November 7, 2024 · 0 reactions · 23 comments · #130088
  • open Reported problem #119794 since June 16, 2024 · 0 reactions · 21 comments · #119794
  • open Reported problem #127315 since October 2, 2024 · 0 reactions · 18 comments · #127315
  • open Reported problem #166223 since March 22, 2026 · 0 reactions · 12 comments · #166223

Fixed

Source: the issue tracker of Home Assistant, as of September 15, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration

Scroll to Top