--- title: "Xiaomi Vacuum" description: "Xiaomi Vacuum is a Marketplace integration for Home Assistant. It has 85 installs sharing analytics, works locally and was last updated October 22, 2026." canonical: "https://vulpo.app/integrations/marketplace/letitbe-dull-xiaomi-vac" url: "https://vulpo.app/integrations/marketplace/letitbe-dull-xiaomi-vac.md" last-updated: "2026-10-27" version: "1.4" --- # Xiaomi Vacuum > Xiaomi Vacuum is a Marketplace integration for Home Assistant. It has 85 installs sharing analytics, works locally and was last updated October 22, 2026. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=letitbe-dull&repository=xiaomi-vac&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=letitbe-dull&repository=xiaomi-vac&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. ### 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](https://github.com/letitbe-dull/xiaomi-vac). ## Entities - **Buttons**: Wash mops, Empty dust bin - **Cameras**: Map - **Numbers**: Volume - **Selects**: System language, Mop drying duration, Fan speed, Water level, Cleaning mode, Sweep type, Active map - **Sensors**: Status, 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 - **Switches**: Repeat 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 map**: Briefly starts the vacuum so it leaves the dock and uploads a fresh map, then sends it back to dock. Fields: Confirm movement ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Turn on the real-time live map ## From the README > Live maps, room cleaning, and local control for supported ijai, Dreame, Viomi, and Xiaomi-labelled vacuums. From the README of [letitbe-dull/xiaomi-vac](https://github.com/letitbe-dull/xiaomi-vac#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: 85 installs sharing analytics; 31 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.5.0, last updated October 22, 2026 - Domain: `xiaomi_vac` - Source: - Issues: In Vulpo: Quick Toggle card, Robot Vacuum card (Pro), Camera card, Button card, 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 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-27. Source: https://vulpo.app/integrations/marketplace/letitbe-dull-xiaomi-vac --- - HTML version of this page: https://vulpo.app/integrations/marketplace/letitbe-dull-xiaomi-vac - 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