--- title: "Xiaomi Home" description: "Xiaomi Home is a built-in integration for Home Assistant. It has 11.6k installs sharing analytics and works locally." canonical: "https://vulpo.app/integrations/core/xiaomi-miio" url: "https://vulpo.app/integrations/core/xiaomi-miio.md" last-updated: "2026-10-22" version: "1.4" --- # Xiaomi Home > Xiaomi Home is a built-in integration for Home Assistant. It has 11.6k installs sharing analytics and works locally. Xiaomi Home is a built-in integration that connects Xiaomi devices to Home Assistant and works locally. It covers many platforms, including vacuums, fans, humidifiers, lights, remotes, switches, sensors and alarms. Setup happens in the UI, where a device can be added with an IP address and API token, or through a Xiaomi account with a server region, and Home Assistant can also discover devices on the network. Beyond basic entities, it offers actions such as resetting a fan filter, setting a light scene, learning an IR command on a remote, and setting a switch power mode. Vacuums can be told to clean specific rooms or zones, or to go to given coordinates. An option lets it use the Xiaomi Home service to get connected subdevices, and a diagnostics file can be downloaded for bug reports. Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=xiaomi_miio) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **Updated with Home Assistant**: Ships and updates with every Home Assistant release. ## Setting it up Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services. ### Enter the address - **IP address** - **API token** ### Cloud - **Server region** - **Password** - **Username** - **Configure manually (not recommended)** ### Connect - **Device model** ### Choose a device - **Device** ### After setup - **Use Xiaomi Home service to get connected subdevices** Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Binary sensors**: Mop attached, Water shortage, Water tank empty, Power supply, Auxiliary heat status, Water tank - **Buttons**: Reset dust filter, Reset upper filter, Reset filter, Reset main brush, Reset sensor dirty, Reset side brush - **Numbers**: Oscillation angle, Delay off countdown, Fan level, Favorite level, Favorite motor speed, LED brightness, Motor speed, Volume - **Selects**: Mode, Display orientation, LED brightness, Auxiliary heat level - **Sensors**: Actual speed, Air quality, Air quality index, Last clean area, Current clean area, Current clean duration, Control speed, Total clean count, DnD end, DnD start, Last clean duration, Total dust collection count, and 24 more - **Switches**: Ionizer, Autodetect, Buzzer, Child lock, Clean mode, Display, Dry mode, Learn mode, LED, Auxiliary heat ## Actions - **Fan reset filter**: Resets the filter lifetime and usage. Fields: Entity ID - **Fan set extra features**: Manipulates a storage register which advertises extra features. The Mi Home app evaluates the value. A feature called "turbo mode" is unlocked in the app on value 1. Fields: Entity ID, Features - **Light eyecare mode off**: Turns off the eyecare mode of a light (EYECARE SMART LAMP 2 ONLY). Fields: Entity ID - **Light eyecare mode on**: Turns on the eyecare mode of a light (EYECARE SMART LAMP 2 ONLY). Fields: Entity ID - **Light night light mode off**: Turns off the night light mode of a light (EYECARE SMART LAMP 2 ONLY). Fields: Entity ID - **Light night light mode on**: Turns on the night light mode of a light (EYECARE SMART LAMP 2 ONLY). Fields: Entity ID - **Light reminder off**: Disables the eye fatigue reminder/notification (EYECARE SMART LAMP 2 ONLY). Fields: Entity ID - **Light reminder on**: Enables the eye fatigue reminder/notification (EYECARE SMART LAMP 2 ONLY). Fields: Entity ID - **Light set delayed turn off**: Sets the delayed turning off of a light. Fields: Entity ID, Time period - **Light set scene**: Sets a fixed scene. Fields: Entity ID, Scene - **Remote learn command**: Learns an IR command. Select Perform action, point the remote at the IR device, and the learned command will be shown as a notification in Overview. Fields: Slot, Timeout - **Remote set LED off**: Turns off the remote’s blue LED. - **Remote set LED on**: Turns on the remote’s blue LED. - **Switch set power mode**: Sets the power mode. Fields: Entity ID, Mode - **Switch set power price**: Sets the power price. Fields: Entity ID, Mode - **Switch set Wi-Fi LED off**: Turns off the Wi-Fi LED of a switch. Fields: Entity ID - **Switch set Wi-Fi LED on**: Turns on the Wi-Fi LED of a switch. Fields: Entity ID - **Vacuum clean segment**: Starts cleaning of the specified segments/rooms. Fields: Segments - **Vacuum clean zone**: Starts the cleaning operation in the selected areas for the number of repeats indicated. Fields: Repeats, Zone - **Vacuum go to**: Sends the robot to the specified coordinates. Fields: X coordinate, Y coordinate ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## At a glance - Kind: Built-in integration - Category: [Hubs and protocols](https://vulpo.app/integrations/category/hubs-and-protocols.md), Smart home hubs - Brand: [Xiaomi](https://vulpo.app/integrations/xiaomi.md) - Number: 11.6k installs sharing analytics - Connection: Works locally - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Domain: `xiaomi_miio` - Source: In Vulpo: Light card, Quick Toggle card, Fan card, Alarm Panel card (Pro), Apple Watch, Control Center, Vacuum Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) ## Other ways in for Xiaomi | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Xiaomi BLE](https://vulpo.app/integrations/core/xiaomi-ble.md) | Built-in integration | 28.1k installs sharing analytics | Works locally | Part of Home Assistant | | [Xiaomi Miot](https://vulpo.app/integrations/marketplace/al-one-hass-xiaomi-miot.md) | Marketplace integration | 21.9k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Xiaomi Home](https://vulpo.app/integrations/marketplace/xiaomi-ha-xiaomi-home.md) | Marketplace integration | 20.2k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Xiaomi Cloud Map Extractor](https://vulpo.app/integrations/marketplace/piotrmachowski-home-assistant-custom-components-xiaomi-cloud-map-extractor.md) | Marketplace integration | 3.4k installs sharing analytics | Needs the vendor's cloud | No update in 6 to 18 months | | [Xiaomi Gateway 3](https://vulpo.app/integrations/marketplace/alexxit-xiaomigateway3.md) | Marketplace integration | 3.2k installs sharing analytics | Works locally | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/xiaomi-miio --- - HTML version of this page: https://vulpo.app/integrations/core/xiaomi-miio - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml