How to Add Xiaomi Vacuum Cleaner to Apple HomeKit on iPhone: A Complete Guide to Error Solutions

Why Xiaomi vacuum cleaner doesn’t work directly with HomeKit and what to do about it

Apple’s HomeKit ecosystem is notorious for being closed: it only supports certified devices with a HomeKit Secure Video chip or MFi (Made for iPhone) protocol. Xiaomi vacuum cleaners — even flagship models like the Mi Robot Vacuum-Mop 2 Pro or DreameBot X30 Ultra — do not have such a certificate. This does not mean that integration is impossible: there are workarounds through hub bridges and third-party applications.

The main problem lies in the communication protocols: Xiaomi uses Mi Home/Xiaomi Home with cloud-based Mi Account binding, while HomeKit requires local Wi-Fi or Bluetooth connectivity LE. Solutions are divided into two types:

• 🔌 Hardware bridges: devices like Home Assistant (on the Raspberry Pi) or Athom Homey Pro that translate Xiaomi commands into the HomeKit protocol.
• 📱 Software solutions: intermediary applications (HomeBridge, HOOBS), HomeKit-based emulating devices API Xiaomi.

It's important to understand that no solution is 100% functional, for example, you can use HomeBridge to start cleaning with your voice ("Hey Siri, turn on the vacuum cleaner"), but you lose access to cleaning maps or setting up areas in Apple Home. In this article, we'll discuss both methods with a focus on free and low-cost options.

Method 1: Connect via HomeBridge (without an additional hub)

If you already have a Mac, iPad or Apple TV as a home hub, HomeBridge is the cheapest solution, open source software that emulates HomeKit devices by pulling data from other ecosystems (including Xiaomi).

• 💻 Computer on the computer macOS/Windows/Linux (or Raspberry Pi for round-the-clock work).
• 🔑 Mi Account with a tied vacuum cleaner in the Mi Home app.
• 📲 Installed Apple Home app on iPhone.

Adjustment steps:

1. Install HomeBridge: npm install -g homebridge homebridge-xiaomi-miio For Windows, use the official instructions.
2. Configure the config: edit the file config.json, adding the Xiaomi Miio plugin: "platforms": [{"platform": "XiaomiMiio", "devices": [{"ip": "192.168.1.100", // IP your vacuum cleaner token": "YOUR_XIAOMI_TOKEN", // The token of the device "model": "miio.vacuum" } ] ] Token can be obtained through the Miio Token Extractor (requires Android-smartphone).
3. Launch HomeBridge and add the device to Apple Home via scan QR-code (will appear in the console logs).

Get a vacuum cleaner token through Miio Token Extractor|

Install Node.js (version 16)+)|Check it out. IP-router|

Disable the firewall/antivirus at the time of setting-->

Limitations of the method:

• ⚠️ No cleaning card support – only basic commands (Start/Stop/Pause).
• ⚠️ Delayed execution of commands up to 2-5 seconds (depends on the cloud Xiaomi).
• ⚠️ Requires a constant HomeBridge (on a Raspberry Pi or always on PC).

💡

If HomeBridge doesn’t see the vacuum cleaner, check that the Mi Home has a Mainland China regional zone, and in other regions, the API can block third-party connections.

Method 2: Home Assistant + HomeKit Integration (Extended Features)

Home Assistant is a more powerful alternative to HomeBridge, which allows you not only to integrate a vacuum cleaner into HomeKit, but also to create complex automation, such as running cleaning on a schedule or in the absence of people at home (via geofences).

Step-by-step:

1. Install Home Assistant on Raspberry Pi or via Docker: docker run -d --name="home-assistant" -e TZ=Europe/Moscow -v /path/to/config:/config --net=host homeassistant/home-assistant:stable
2. In the web interface (http://[IP_yours]:8123) Go to Settings. → Devices and services → Add integration and choose Xiaomi Miio.
3. Enter. IP-vacuum cleaner address and token (previously received). Once the device is detected, add it to HomeKit via the Settings menu → Integration → HomeKit.

Advantages of HomeBridge:

• 📊 Support for cleaning cards (through custom components like Xiaomi Miio Map).
• 🔄 Ability to create automation (e.g., cleaning on schedule or at low charge level).
• 🛡️ Local management (without depending on the cloud).

⚠️ Note: If Xiaomi vacuum cleaner updated the firmware after connecting to Home Assistant, the token may reset, in which case you will have to get a new token and reconfigure the integration.

Comparison of Integration Methods: What to Choose

The choice of method depends on your tasks and technical capabilities. Below is a comparative table of key parameters:

A critical nuance: Xiaomi vacuum cleaners with firmware newer than 2023 can block third-party connections through APIs. In this case, only a hardware hub like Homey Pro or a firmware rollback (risky!) will help.

💡

For most users, the Home Assistant is optimal – it is cheaper than Homey Pro and more functional than HomeBridge, but requires customization skills.

Common mistakes and their solutions

Even if you set up the integration correctly, it might not work, and here are the typical problems and ways to fix them:

• 🔴 "Device not responding" in HomeKit: Check that the vacuum cleaner and device with HomeBridge/Home The Assistant is on the same Wi-Fi network. VPN Or Pi-hole, they can block local requests. Reset the vacuum cleaner (hold the power button). 10 seconds).
• 🔴 "Wrong token": Get a new token through Miio Token Extractor (the old one could have reset after the firmware update). Make sure the China zone is selected in Mi Home.
• 🔴 Vacuum is not displayed in HomeKit: Check Logs HomeBridge/Home Assistant to Errors (homebridge team) -D or the Logs section in HA). Remove the device from Apple Home and add it again.

⚠️ Note: If Xiaomi vacuum cleaner was previously linked to another Mi Account, it must be reset to factory settings (Settings) → Reset in the Mi Home app, otherwise the new token will not be available.

Alternative ways to control the vacuum cleaner through the iPhone

If integration with HomeKit seems too complicated, consider alternative options for managing Xiaomi’s vacuum cleaner with iPhone:

• 📱 Mi Home: Official solution with full functionality (maps, zones, schedule) minus: no integration with Siri or Apple Home.
• 🤖 Google Assistant + Shortcuts: Connect the vacuum cleaner to Google Home, then create a Shortcut on your iPhone with a command for Google Assistant. Example: voice command "Hey Siri, start cleaning up" → Calling Google Assistant with Shortcuts.
• 🌐 IFTTT (If supported: Some Xiaomi models are compatible with IFTTT — You can create an applet to control through Apple Shortcuts.

Pros of alternatives:

• ✅ No additional hardware is required (except for Google Home for the second option).
• ✅ Keep all the functionality of the vacuum cleaner (maps, zones, cleaning intensity).

Cons:

• ❌ No native integration with HomeKit (will not appear in the Home app).
• ❌ Dependence on Third-Party Services (Google, IFTTT), changeable API.

FAQ: Frequent questions about Xiaomi’s integration with HomeKit