Xiaomi Vacuum for Home Assistant (Marketplace integration)

Installs: 85 sharing analytics
GitHub stars: 31
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v1.5.0, October 22, 2026
Category: Appliances and cleaning, Cleaning
Kind: Marketplace integration
Brand: Xiaomi
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: xiaomi_vac
Source: github.com/letitbe-dull/xiaomi-vac
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 controlling supported ijai, Dreame, Viomi and Xiaomi-labelled robot vacuums. Control runs locally, and signing in with a Mi account is optional, needed only for the live map. It adds a vacuum entity along with buttons to wash mops and empty the dust bin, selects for fan speed, water level and cleaning mode, and sensors for battery, status, brush and filter life. The map camera shows the current vacuum map, and devices with several maps can switch between them. An action cleans chosen rooms by their map room id, and another refreshes the map by briefly sending the vacuum out of its dock. A bundled dashboard card offers vacuum controls and room selection, and setup is done in the UI.

Automatic summary of the README and code of letitbe-dull/xiaomi-vac. 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.

Provides

Cameras
Vacuums
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Sign in to Mi Home

Email, phone number or Mi account ID
Password

Also asked when signing in again.

Local connection

IP address
Token

Quick human check

Characters from the image

Enter the code

Verification code

Choose your vacuum

Vacuum

Enable real-time map auth

Enable OAuth for real-time map updates

Paste Xiaomi OAuth code

OAuth code

After setup

OAuth code

Texts from the code of letitbe-dull/xiaomi-vac.

Entities

ButtonsWash mops, Empty dust bin
CamerasMap
NumbersVolume
SelectsSystem language, Mop drying duration, Fan speed, Water level, Cleaning mode, Sweep type, Active map
SensorsStatus, Base station status, Dirty water tank, Clean water tank, Battery, Dust/water tank, Clean area, Clean time, Main brush life, Side brush life, Filter life, Mop life, and 5 more
SwitchesRepeat clean, Find vacuum (beep), Automatic mop drying, Dry mops

Actions

Clean room(s)Start cleaning one or more rooms by their map room id.Fields: Rooms
Refresh mapBriefly starts the vacuum so it leaves the dock and uploads a fresh map, then sends it back to dock.Fields: Confirm movement

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Turn on the real-time live map