--- title: "Xiaomi Vacuum" description: "Xiaomi Vacuum is a Marketplace integration for Home Assistant. It has 95 installs sharing analytics, works locally and was last updated October 26, 2026." canonical: "https://vulpo.app/integrations/marketplace/roquerodrigo-ha-xiaomi-vacuum" url: "https://vulpo.app/integrations/marketplace/roquerodrigo-ha-xiaomi-vacuum.md" last-updated: "2026-10-22" version: "1.4" --- # Xiaomi Vacuum > Xiaomi Vacuum is a Marketplace integration for Home Assistant. It has 95 installs sharing analytics, works locally and was last updated October 26, 2026. Xiaomi Vacuum is an integration for Xiaomi robot vacuums, covering the X20 Max, S20+ and S40 Pro models. Control and state polling run locally over the MIoT protocol, while the Xiaomi cloud is used for the one-time login in setup, the map image and localized error text. It adds a vacuum entity with standard controls, plus sensors for status, error and the remaining life of the mop, brushes and filter. Selects cover cleaning mode, repetitions, mop water level, sweep route and obstacle avoidance, and the S20+ omits the last two. Rooms reported by the device can be mapped to Home Assistant areas, and the X20 Max also has actions for zone cleaning and for starting a custom cleaning saved in the Mi Home app. Setup is done in the UI, where the Xiaomi cloud region and the vacuum are chosen. Automatic summary of the README and code of roquerodrigo/ha-xiaomi-vacuum. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=roquerodrigo&repository=ha-xiaomi-vacuum&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=roquerodrigo&repository=ha-xiaomi-vacuum&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Choose your Xiaomi cloud region - **Region**: The Mi Home cloud server that hosts your account. Also asked when changing the connection. ### Pick your vacuum - **Vacuum** Texts from the code of [roquerodrigo/ha-xiaomi-vacuum](https://github.com/roquerodrigo/ha-xiaomi-vacuum). ## Entities - **Binary sensors**: Cleaning in progress, Mop pad - **Buttons**: Collect dust - **Images**: Map - **Selects**: Mode, Clean times, Mop water level, Sweep route, Obstacle avoidance - **Sensors**: Status, Error, Error code, Mop life, Side brush life, Filter life, Main brush life ## Actions - **Clean zone**: Cleans one or more rectangles drawn in the vacuum's map coordinates. Fields: Zones, Repeats - **Start custom cleaning**: Starts a custom cleaning saved in the Mi Home app, with the rooms or zones and the settings stored in it. Fields: Name ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Is an unsupported model ## From the README > A Home Assistant integration for the Xiaomi Robot Vacuum X20 Max (xiaomi.vacuum.d109gl), Xiaomi Robot Vacuum S20+ (xiaomi.vacuum.b108gl) and Xiaomi Robot Vacuum S40 Pro (xiaomi.vacuum.ov71gl). > > Day-to-day control and state polling run locally over the MIoT protocol (iot\_class: local\_polling). The Xiaomi cloud is used for one-time setup — a QR login that discovers the vacuum and fetches its IP and token for you — and for two cloud-only extras: the map image and localized error messages. > > - Vacuum entity with the standard HA controls: start, pause, stop, return to dock, locate, fan speed, battery, state. > - Native segment cleaning — exposes the rooms reported by the device so you can use Home Assistant's Settings → Devices & services → Entities → vacuum → ⚙ → Map vacuum segments to areas dialog and… > - Zone cleaning (X20 Max) — the xiaomi\_vacuum.clean\_zone action cleans one or more rectangles drawn in the vacuum's map coordinates, optionally setting the number of repeats. See > - Custom cleanings (X20 Max) — the xiaomi\_vacuum.start\_custom\_cleaning action starts a custom cleaning saved in the Mi Home app by its name. See > - Map image — the live map is rendered from the Xiaomi cloud as an image entity you can drop on a dashboard. > - Error reporting — Error (localized, human-readable fault text resolved from the Xiaomi cloud message feed) and Error code sensors. The fault is read from the device's live fault list, so it clears… From the README of [roquerodrigo/ha-xiaomi-vacuum](https://github.com/roquerodrigo/ha-xiaomi-vacuum#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Appliances and cleaning](https://vulpo.app/integrations/category/appliances-and-cleaning.md), Cleaning - Brand: [Xiaomi](https://vulpo.app/integrations/xiaomi.md) - Number: 95 installs sharing analytics; 10 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2.7.0, last updated October 26, 2026 - Domain: `xiaomi_vacuum` - Source: - Issues: ## 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 Home](https://vulpo.app/integrations/core/xiaomi-miio.md) | Built-in integration | 11.6k installs sharing analytics | Works locally | Part of Home Assistant | | [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 | 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/marketplace/roquerodrigo-ha-xiaomi-vacuum --- - HTML version of this page: https://vulpo.app/integrations/marketplace/roquerodrigo-ha-xiaomi-vacuum - 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