How to add a Xiaomi desktop lamp to HomeKit: 3 working ways (without jailbreak)

Integrating Xiaomi smart bulbs into the Apple HomeKit ecosystem is no easy task, because Xiaomi does not officially support the HomeKit protocol for most of its devices, including popular table lamps like the Mi LED Desk Lamp or Yeelight. However, this does not mean that iPhone and Mac owners will have to give up the convenience of managing lighting through the Home. There are at least three reliable ways to get around this limitation - and all of them do not require hacking devices or using outdated firmware.

The main problem is that Xiaomi's protocols are closed, and the company's lamps run through its own cloud services (Mi Home/Yeelight) or local networks using MiIO protocol, which is incompatible with HomeKit out of the box. But with open solutions like Home Assistant, specialized hubs (Aqara, Athom) or cloud bridges (HomeBridge), integration is possible. In this article, we'll take each method by step, point out pitfalls, and give you recommendations for choosing the best option for your lamp model.

Before you start, make sure your lamp supports at least one of the following protocols:

• 🔹 MiIO – local protocol Xiaomi (works over Wi-Fi)
• 🔹 Zigbee – for lamps connected via Aqara or MiJia hubs
• 🔹 Bluetooth Mesh is rare but found in newer models

If the lamp housing has a Yeelight logo, it is likely MiIO compatible. Check out the Mi Home app – if the device is displayed on a local network (without the cloud), the chances of successful integration are higher.

Method 1: Home Assistant (most universal)

Home Assistant is an open-source smart home platform that can translate Xiaomi protocols into HomeKit, and the advantage is flexibility: you can control the lamp not only through the Home, but also through the Home Assistant web interface, create complex automations, and even integrate devices from other brands.

First of all, you'll need:

• 🖥️ Computer or Raspberry Pi (recommended by Raspberry Pi 4 or later)
• 🔌 Stable connection to the local network (lamp and server must be in the same subnet)
• 📱 Home Assistant for iOS or Web Browser

Steps to set up:

1. Install Home Assistant on your device. The easiest way to use the Home Assistant OS image for the Raspberry Pi is to use the Home Assistant OS image (you can download it from the official website).
2. After you start, open the web interface at http://homeassistant.local:8123 (or your server’s IP).
3. Go to Settings → Devices and Services → Add Integration and find Xiaomi Miio.
4. Enter data from your Mi Home account (login and password) or use the device token (how to get it – read below).
5. Once successfully connected, the lamp will appear in the list of devices. Now add Apple HomeKit integration through the same section and follow the instructions on the screen.

To get a device token for MiIO, use the MiHome Token Extractor utility (available for Android) or a script in Python:

pip install python-miio


mirobo --debug --ip 192.168.x.x discover

192.168.x.x

Make sure the lamp is connected to Wi-Fi|Check the lamp firmware version (update if necessary)|Shut down. VPN on the Home Assistant server|Write it down. IP-Lamp address (find in router or via Mi Home)-->

Method 2: Use HomeBridge (for users without Raspberry Pi)

HomeBridge is a lightweight server that emulates HomeKit devices for incompatible hardware. Unlike Home Assistant, it doesn’t require a separate computer and can run on a Mac, Windows, or even a NAS (like Synology).

Installation of HomeBridge on Mac (via Terminal):

sudo npm install -g --unsafe-perm homebridge


sudo npm install -g homebridge-miio

After installation:

1. Create a config.json configuration file in the ~/.homebridge folder:
2. Add a lamp unit (example for Yeelight): {"platforms": [{"platform": "Miio," "devices": [{"ip": "192.168.x.x," "token": "your token of miio," "model": "yeelink.light.lamp1" } ] } }
3. Run HomeBridge with the Homebridge command.
4. Open the Home app on your iPhone and add a new device through scanning QR-code (it will appear in the terminal after launch).

Important: If the lamp is not displayed in HomeKit, check that the router settings have turned off AP Isolation, which blocks the exchange of data between devices on the local network.

Home Assistant (full control)|HomeBridge (simplicity)|Cloudbridge (no server)|I haven't decided-->

Method 3: Through the Aqara or Athom hub (for Zigbee lamps)

If your Xiaomi desktop lamp is running on the Zigbee protocol (for example, MiJia Bedside Lamp), it can be connected to HomeKit through a compatible hub.

• 🔄 Aqara Hub M2 — Officially certified for HomeKit, it supports up to 128 devices.
• 🔄 Athom Homey Pro – universal hub with support for Zigbee, Z-Wave and Wi-Fi.
• 🔄 Mi Smart Home Gateway – Requires Home Assistant firmware to integrate with HomeKit.

Instructions for the Aqara Hub M2:

1. Connect the hub to power and add it to the home via scans QR-code (located at the bottom of the device).
2. In the Aqara app, go to Add Device → Lighting and follow the instructions to connect the lamp.
3. After successful addition, the lamp will automatically appear in the HomeKit.

If you use the Mi Smart Home Gateway, you will need to flash it through alternative software (for example, the software is not available, Zigbee2MQTT) And it's a little bit more complicated, but it's cheaper, and it's a little more expensive. ~20$, whereas Aqara Hub M2 cost ~50$.

Common mistakes and their solutions

Even with the right instructions, there can be problems, and here are the most common ones and ways to fix them:

If the lamp flashes or becomes unstable after integration, try resetting it to the factory settings.

1. Turn the lamp off the socket.
2. Press the power button for 5-10 seconds.
3. Connect to the power, without releasing the button until the lamp blinks 3 times.

💡

If the Yeelight lamp doesn't want to connect, try using the Yeelight app instead of Mi Home. Sometimes it works better with local MiIO protocol.

Comparison of Integration Methods: What to Choose?

Each of these methods has its pros and cons, and here is a quick comparison to help you choose:

Selection recommendations:

• 🔧 If you need complex automation (for example, changing the color of the lamp depending on the time of day) – choose Home Assistant.
• 💻 If you already have Mac/PC If you don’t want to buy extra iron, stop at HomeBridge.
• 🏠 If the lamp supports Zigbee and you want stability, take the Aqara hub.

💡

Yeelight lamps with firmware until 2021 may require a rollback of the software version. New firmware blocks access via local MiIO protocol without the cloud.

Security: How to protect your network?

Integrating smart devices into a local network is always risky, and here are some tips on how to minimize threats:

• 🔒 Create a separate network for smart devices in the router (guest network or network) VLAN).
• 🔄 Regularly update the lamp firmware, Home Assistant and HomeBridge.
• 🚫 Disable access to devices from the Internet (close ports 80, 443, 51826 for external connections in the router settings).
• 🔑 Use complex passwords for Mi Home and Home Assistant accounts.

⚠️ Note: If you are using HomeBridge on Windows, do not run it on behalf of the administrator. This can open vulnerabilities in the system.

For additional protection, you can set up a firewall on the router to limit the exchange of data between devices. IP-Home Assistant server address and block other connections.

FAQ: Frequent questions about Xiaomi lamp integration in HomeKit