How to add a robot vacuum cleaner Xiaomi in the app β€œHome” on the iPhone: 3 working methods (2026)

Xiaomi’s robot vacuum cleaners have long been an integral part of smart homes, but their integration with the Apple HomeKit ecosystem still raises questions. Unlike Ecovacs or iRobot devices, which support HomeKit out of the box, Mi Robot, Dreame or Viomi vacuum cleaners require additional manipulation. This article reveals all the current ways of connecting – from official (via Mi Home) to alternative (using Home Assistant or other devices). HOOBS).

The main problem is that Xiaomi does not certify its vacuum cleaners to work with HomeKit due to the closed Apple protocol, but there are workarounds – and we will discuss each of them in detail, including nuances for different models (from Mi Robot Vacuum-Mop 2 Pro to DreameBot). D9 Important: Some methods will require an iPhone with iOS 16+, Additional equipment (e.g. Raspberry Pi for Home Assistant).

If you're looking for the easiest way to do this, start with the first section about Mi Home. For advanced users who are ready to set up servers, Home Assistant is the best way to do this. And for those who want to avoid the complications, we'll talk about paid cloud services like Athom Homey or HomeBridge.

1.Preparation: What will be needed to connect

Before you start integration, make sure you have everything you need. The minimum requirements depend on the method you choose, but the basic set is the same for all methods:

  • πŸ“± iPhone with iOS 15.4+ (recommended for iOS 16+ for stable operation of HomeKit).
  • πŸ€– Xiaomi Robot Vacuum Cleaner (any model, but check compatibility in the table below).
  • πŸ“Ά Stable 2.4GHz Wi-Fi connection (most vacuum cleaners do not support 5GHz).
  • πŸ”Œ Charged vacuum cleaner battery (at least 20%, otherwise it may turn off during setup).

Some methods will require additional devices or programs:

Connection methodAdditional equipment/POLevel of difficulty
Through Mi Home + HomeKitMi Account, Mi Home app⭐ (simple)
Through Home AssistantRaspberry Pi or server, Docker, Xiaomi Miio plugin⭐⭐⭐ (difficult)
Through HOOBS/HomeBridgeRaspberry Pi or HOOBS Box, plugin mi-robot-vacuum⭐⭐ (middle-of-the-road)
Through Cloud Services (Homey)Homey Pro Device or Cloud Subscription⭐⭐ (middle-of-the-road)

Important: If your vacuum cleaner is released before 2019, check if it supports Miio protocol.Old models (such as Mi Robot Vacuum 1) may not connect to HomeKit even through workarounds.A list of compatible devices can be found on the official Home Assistant page.

⚠️ Note: If you are using an iPhone with iOS 17+, Before setting up, disable the HomeKit Security Warnings function in Settings β†’ HomeKit.Otherwise, the system may block uncertified devices.

πŸ“Š What kind of robot vacuum cleaner Xiaomi you have?
Mi Robot Vacuum-Mop 2 Pro
DreameBot D9/D10
Viomi V2/V3
Mi Robot Vacuum 1S
Another model
I haven't bought it yet.

2. Method 1: Official connection via Mi Home (without HomeKit)

This method does not provide full integration with HomeKit, but allows you to control the vacuum cleaner through the Mi Home app and add it to the Home as an accessory with limited functionality.

Steps for connection:

  1. Install the Mi Home app: πŸ“² Download Mi Home from the App Store. πŸ”‘ Sign up or sign in to your Xiaomi account (be sure to link your phone number to restore access).
  2. Add a vacuum cleaner to Mi Home: 🏠 Press Β«+Β» β†’ Β«Add the deviceΒ». πŸ” Select the category "Vacilities" and find your model. πŸ“Ά Connect the vacuum cleaner to 2.4GHz Wi-Fi (press and hold the "Wi-Fi" button on the vacuum cleaner body until the audible signal is heard).
  3. Set up integration with the β€œHomeΒ»: πŸ”— In Mi Home go to the vacuum cleaner settings β†’ Β«HomeKit settings (if such a point exists). 🍎 Scan it. QR-code through the app "Home" on the iPhone.

Limitations of this method:

  • ❌ No support for HomeKit automation (e.g., geolocation startup).
  • ❌ Notifications of vacuum cleaner status come only in Mi Home.
  • ❌ No way to manage cleaning through the β€œhouseΒ».

Make sure the vacuum cleaner is connected to 2.4 GHz Wi-Fi|

Update the vacuum cleaner firmware to the latest version|

Disable VPN on iPhone|

Log in to one Xiaomi account on all devices-->

⚠️ Note: If the vacuum cleaner doesn’t appear in Home after adding it, try restarting your iPhone and re-scanning it. QR-Sometimes helps reset HomeKit: Settings β†’ HomeKit β†’ Reset the configuration of the house.

Method 2: Full integration through Home Assistant (for advanced)

If you need full support for HomeKit with all the vacuum cleaner features (zone cleaning, power management, schedule), the best option is to use Home Assistant, which requires server skills, but gives you maximum flexibility.

You'll need:

  • πŸ–₯️ Raspberry Pi 4-based server (or any other computer with Docker).
  • 🌐 Installed Home Assistant (instructions on the official website).
  • πŸ”‘ Token from Mi Home account (you can get through this script).

Step-by-step:

  1. Install the Xiaomi Miio plugin: 1. Go to Settings β†’ Devices and services β†’ Add integration. 2. Find Xiaomi Miio and enter account details. 3. Select your vacuum cleaner from the list of devices.
  2. Set up a connection with HomeKit: 1. In Home Assistant, go to Settings β†’ Devices and services β†’ HomeKit. 2. Enable the option "Enable HomeKit Controller." 3. Scan QR-code through the app "Home" on the iPhone.
  3. Add automation (optional): Example of automatic cleaning on schedule: automation: - alias: "Wideday cleaning on weekdays 10:00" trigger: platform: time at: "10:00:00" condition: condition: time weekday: - mon - tue - wed - thu - fri action: service: vacuum.start target: entity_id: vacuum.xiaomi_vacuum_cleaner

Advantages of this method:

  • βœ… Complete control of the vacuum cleaner via HomeKit and Siri.
  • βœ… Support for zone cleaning, power modes, battery status.
  • βœ… Ability to create complex automation (e.g., start cleaning in the absence of a home).
How to Get Mi Home Token Without Official API
1. Install Packet Capture on your Android device. 2. Start capturing traffic and log in to Mi Home. 3. Find a request to api.io.mi.com and it will be the line "token": "...". 4. Copy the token and use it in Home Assistant. ⚠️ The token is valid for a limited time (usually) 1-2 months after which the procedure must be repeated.

⚠️ Warning: If the vacuum cleaner does not respond to HomeKit commands after setting up, check: Is the Home Assistant server working (port 8123 must be open), has the token changed in the Mi Home account (after changing the password, the token is reset) Is the vacuum cleaner connected to the same network as the server.

Method 3: Use of HOOBS HomeBridge (alternative to Home Assistant)

If the Home Assistant is too difficult, you can use it. HOOBS β€” It's a simplified version of HomeBridge with a graphical interface, and it's suitable for users who want to avoid using the console, but get full integration with HomeKit.

What you need:

  • πŸ–₯️ Raspberry Pi 3/4 or HOOBS Box (you can buy a ready-made device).
  • πŸ”Œ Installed HOOBS (Download the image from the official website).
  • πŸ”‘ Mi Home account details (login and password).

Instructions for setting:

  1. Install. HOOBS: πŸ“€ Write the image on a microSD card using BalenaEtcher. πŸ”Œ Connect the Raspberry Pi to the network and wait for the download (access to the address) http://hoobs.local).
  2. Add a plugin for Xiaomi: πŸ”§ Go to Plugins. β†’ Install New Plugin. πŸ” Find a homebridge-mi-robot-vacuum and install it. βš™οΈ In the settings of the plugin, specify IP-Token and vacuum cleaner address (you can get it through Mi Home or Packet Capture).
  3. Connect to HomeKit: 🍎 Open the Home app on your iPhone and add a new accessory. πŸ” Scan it. QR-code that appears in the interface HOOBS.

Comparison HOOBS Home Assistant and Home Assistant:

CriteriaHOOBSHome Assistant
Difficulty setting up⭐⭐ (middle-class)⭐⭐⭐ (high-pitched)
Support for devicesLimited to pluginsBroad (thousands of integrations)
CostFree (or ~$100 for a buck. HOOBS Box)Free of charge.
AutomationBasicExtended (YAML, Node-RED)

πŸ’‘

If HOOBS If you can’t find a vacuum cleaner, try manually pointing IP-the address of the device in the plugin settings. IP You can use the router (partition) DHCP Clients) or Fing application.

5. Method 4: Cloud Services (Athom Homey, Yandex Alice)

If you don't want to mess with servers, but you need to integrate with HomeKit, you can use cloud hubs like Athom Homey Pro or Yandex Station, followed by a bridge to Home, which is a paid method, but does not require technical skills.

Option 1: Athom Homey Pro

  • πŸ›’ Buy a Homey Pro device (~15,000 rubles.).
  • πŸ”Œ Connect it to the network and add a vacuum cleaner through the Homey app.
  • 🍎 Integrate Homey with HomeKit through the Official Plugin.

Option 2: Yandex Alice + HomeKit

  • 🎀 Connect the vacuum cleaner to Yandex Alice via Mi Home.
  • πŸ”— Use a Home Assistant or HOOBS Like a bridge between Alice and HomeKit.
  • ⚠️ This method is unstable and requires a constant Internet connection.

The advantages of cloud services:

  • βœ… There is no need to configure the server.
  • βœ… Support for other devices (lighting, sockets, etc.).
  • βœ… Stable work (if the Internet is not turned off).

Cons:

  • ❌ Paid equipment (Homey Pro or Raspberry Pi) + subscription).
  • ❌ Cloud dependency (in case of service failure, management disappears).
  • ❌ Limited Automation Opportunities Compared to Home Assistant.

πŸ’‘

Cloud services are suitable for users who do not want to know how to set up servers, but are willing to pay for convenience, but to fully control the vacuum cleaner, it is better to use local solutions (Home Assistant or Home Assistant). HOOBS).

6. Problem Solving: Frequent Errors and Corrections

Even if you follow the instructions accurately, you can get errors, and we'll look at the most common ones and how to fix them.

Problem 1: The vacuum cleaner is not connected to Wi-Fi

  • πŸ”Œ Make sure the router is running in mode. 802.11n (not 802.11ac).
  • πŸ”’ Turn it off. WPA3 in the router settings (use) WPA2-PSK).
  • πŸ“΅ Check that there are no restrictions on the network. MAC-address.

Problem 2: HomeKit doesn’t see vacuum cleaner after adding

  • πŸ”„ Reboot iPhone and vacuum cleaner.
  • πŸ”§ In Mi Home, update the vacuum cleaner firmware to the latest version.
  • 🚫 Remove the vacuum cleaner from the Mi Home and add it again.

Problem 3: HomeKit commands are executed with a delay

  • 🌐 Check the Internet speed (minimum 5 Mbps).
  • πŸ“‘ If you use Home Assistant, make sure that the server is not overloaded.
  • πŸ”Œ Switch the vacuum cleaner to static IP-router.

Problem 4: β€œCan’t add an accessory” error

  • πŸ”‘ Make sure your iPhone has Bluetooth and Wi-Fi enabled.
  • πŸ“± Update iOS to the latest version.
  • 🏠 Reset HomeKit Settings: Settings β†’ HomeKit β†’ Remove the house (Warning: This will remove all devices!).
How to Reset Xiaomi Vacuum to Factory Settings
1. Press the power button 5 seconds before the beep. 2. Wait until the indicator flashes orange. 3. Press the button again to confirm the reset. ⚠️ After resetting, the vacuum cleaner will lose all saved maps and settings.

7. Comparison of methods: which one to choose?

The choice of integration method depends on your technical skills and functionality requirements, and here is a comparison table for convenience.

MethodDifficultyCostFunctionalityStability
Mi Home + HomeKit⭐ (simple)Free of charge.Limited.⭐⭐⭐⭐
Home Assistant⭐⭐⭐ (difficult)Free (needs server)Complete.⭐⭐⭐⭐⭐
HOOBS/HomeBridge⭐⭐ (middle-of-the-road)Free of charge (~$100 for a buck. HOOBS Box)Complete.⭐⭐⭐⭐
Athom Homey⭐ (simple)~15,000 rubles.Complete.⭐⭐⭐⭐
Yandex Alice + bridge⭐⭐ (middle-of-the-road)Free (needs server)Limited.⭐⭐⭐

Selection recommendations:

  • πŸ† For maximum control: Home Assistant (if you are ready to understand the settings).
  • πŸ’° For those who don’t want to mess around: Athom Homey Pro (paid but simple).
  • πŸ†“ For basic management: Mi Home + HomeKit (free but with limited restrictions).
  • πŸ› οΈ For lovers of homemade solutions: HOOBS (middle-of-the-road).

FAQ: Frequent questions

❓ Can you connect older Xiaomi models (such as Mi Robot Vacuum 1) to HomeKit?
The older models (2016-2018) do not support Miio 2.0, so integration will require: Use Home Assistant with the miio plugin in legacy mode. IR-blaster (e.g. BroadLink) RM4 Pro) and operate the vacuum cleaner via an infrared port (but that will only give basic commands).+.
❓ Why the vacuum cleaner is disconnected from HomeKit after updating the firmware?
This is a common problem, because Xiaomi is changing the protocols for data exchange: πŸ”„ Update the Xiaomi Miio plugin to Home Assistant or HOOBS. πŸ”‘ Get a new token (the old one can be reset). πŸ“΅ Reverse the vacuum cleaner firmware to the previous version (if possible). If nothing helps, wait for the plugin update from the developers (usually released within 1-2 weeks after the firmware release).
❓ Can you manage zone cleaning through HomeKit?
Yes, but only if you use a Home Assistant or HOOBS. In basic integration via Mi Home, this feature is not available to configure zone cleaning: 1. In Home Assistant, go to Developer Tools β†’ Services. 2. Select a service vacuum.clean_zone. 3. Specify the parameters: - entity_id: vacuum.xiaomi_vacuum - zone: [[x1, y1, x2, y2]] (coordinates of the zone from the map) - repeats: 2 (Number of passes) For convenience, you can create a script in HomeKit and run it with voice through Siri.
❓ Will the vacuum cleaner work with HomeKit without the Internet?
Depends on the method of connection: βœ… Home Assistant: Yes, if the server and vacuum cleaner are on the same network. βœ… HOOBS/HomeBridge: Yes, with local connection. ❌ Mi Home + HomeKit: No, you need a Xiaomi cloud. ❌ Athom Homey: No, it depends on the cloud. For fully autonomous work, set up Home Assistant with local management.
❓ Which Xiaomi robot vacuum cleaner integrates best with HomeKit?
Most compatible models (in descending): Xiaomi Mi Robot Vacuum-Mop 2 Pro - full support via Miio, including zone cleaning. D9/D10 β€” Stable work with Home Assistant, support LDS-map. V3 β€” A good alternative, but requires manual token setup.Mi Robot Vacuum 1S β€” basic support, but without some features (e.g. water management) check the combo before buying