Xiaomi Vacuum for Home Assistant (Marketplace integration)

Installs: 95 sharing analytics
GitHub stars: 10
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v2.7.0, October 26, 2026
Category: Appliances and cleaning, Cleaning
Kind: Marketplace integration
Brand: Xiaomi
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: xiaomi_vacuum
Source: github.com/roquerodrigo/ha-xiaomi-vacuum
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

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

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

RegionThe 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.

Entities

Binary sensorsCleaning in progress, Mop pad
ButtonsCollect dust
ImagesMap
SelectsMode, Clean times, Mop water level, Sweep route, Obstacle avoidance
SensorsStatus, Error, Error code, Mop life, Side brush life, Filter life, Main brush life

Actions

Clean zoneCleans one or more rectangles drawn in the vacuum's map coordinates.Fields: Zones, Repeats
Start custom cleaningStarts a custom cleaning saved in the Mi Home app, with the rooms or zones and the settings stored in it.Fields: Name

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices 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, MIT License. Shortened.