How to connect a Xiaomi lamp to HomeKit: 3 working methods (without a hub and with Home Assistant)

Xiaomi smart bulbs are some of the most popular lighting devices in the smart home ecosystem, but their native integration with Apple's HomeKit is often questionable. Unlike Philips Hue or Nanoleaf, most Yeelight and Mi models are the most popular. LED They don't support HomeKit out of the box, but that doesn't mean they can't be connected: there are workarounds over Home Assistant, third-party bridges, or even branded hubs with firmware from the community.

In this article, we will discuss three proven integration methods, from the simplest (via Home Assistant) to alternative solutions for users without a server. LED Desk Lamp 1S) You can find solutions here, if you've tried to plug in the lamp and you get the message "Accessory is not responding" or "Can't add to HomeKit" - here you will find solutions.

1.Why does Xiaomi lamps not work directly with HomeKit?

The main reason is the lack of MFi (Made for) certification. iPhone/iPad) The company is focusing on its own Mi Home ecosystem and the Zigbee protocol (for devices with a hub), while Apple requires manufacturers to do so:

• 🔐 Hardware support for the HomeKit chip (like in Nanoleaf or Eve lamps).
• 📜 Certifying every device at Apple, which costs money and time.
• 🔄 Updates to the firmware with protocol support HAP (HomeKit Accessory Protocol).

The exceptions are rare models, for example, Xiaomi Mi. LED Smart Bulb (Zigbee) with firmware from third-party developers (for example, Zigbee2MQTT). However, even in this case, additional software is required for the bridge between Zigbee and HomeKit.

⚠️ Note: Yeelight lamps (e.g. Yeelight Color 2 or Yeelight) LED Strip Plus) use Wi-Fi and are not compatible with HomeKit without an intermediary, and can only be connected via Home Assistant or cloud services like HomeBridge.

Method 1: Connecting through Home Assistant (recommended)

Home Assistant is an open platform for smart homes that can act as a bridge between Xiaomi and HomeKit.

• 🔌 Local management (without depending on the cloud).
• 🛠️ Support for almost all lamp models Xiaomi/Yeelight.
• 🔄 Automation between devices of different brands.

The setup will require:

1. Installed Home Assistant (on Raspberry Pi, NAS or in Docker).
2. Xiaomi Miio or Yeelight integration (depending on the lamp model)
3. The HomeKit Controller or HomeKit Bridge.

Install Home Assistant (version 2026.6 or later)|

Add integration of "Xiaomi Miio" through Settings → Devices and services|

Get a device token through the Mi Home app (instruction below)|

Install the HomeKit Bridge extension from HACS|

Reboot Home Assistant after settings

-->

Step-by-step:

1. Get the device token:

Open the Mi Home app, find your lamp in the list of devices and copy it to Device ID And Token:

1. Go to profile → “About the program” → “Debugging options”.


2. Enable "Wi-Fi Debugging" and "Bluetoothbug."




3. Use the Miio Debug tool to get a token.

2. Add the lamp to the Home Assistant:

Go to Settings. → Devices and services → Add integration and select Xiaomi Miio. type in IP-Lamp address (find it in router), Device ID Token.

3. Set up the bridge in HomeKit:

Install the HomeKit Bridge expansion from HACS (Home Assistant Community Store after installation:

1. Go to Settings → Additions → HomeKit Bridge.


2. Click "Start" and scan the QR- code through the Home app on your iPhone.




3.The lamp will appear in HomeKit as an accessory.

⚠️ Note: If the lamp does not appear in HomeKit after you have set up the bridge, check it out: 🔌 Connect Home Assistant and Lamps to a Wi-Fi Network. 🔄 Xiaomi Miio integration version (update via the HACS). 📱 Home Assistant permissions in router settings (open ports 8123 and 21063).

💡

Home Assistant is the most reliable way to integrate, but requires constant server operation. For users without technical skills, HomeBridge is the best way to do this.

Method 2: Use HomeBridge (for users without Home Assistant)

HomeBridge is a lightweight server that emulates a HomeKit bridge on your computer or Raspberry Pi. Unlike Home Assistant, it does not require complex configuration, but has limitations:

• ⚡ It only works when the device is on (for example, Mac mini or Raspberry Pi).
• 🌐 Depends on the Xiaomi cloud (unless you use local plugins).
• 🔧 Requires manual configuration of the configuration file.

To get started:

1. Install HomeBridge on your device (instructions for Windows, macOS, Raspberry Pi).
2. Install a plugin for Xiaomi:

npm install -g homebridge-xiaomi-miio

3. Set up. config.json:

{


"platforms": [




{




"platform": "XiaomiMiio",




"devices": [




{




"ip": "192.168.1.100",




"token": "YOUR_DEVICE_TOKEN",




"name": "Xiaomi Lamp"




}




]




}




]




}

4. Launch HomeBridge and add the lamp to HomeKit via the Home app on iPhone (will appear) QR-code).

💡

If the lamp flashes after connecting to HomeKit, check the settings of the homebridge-xiaomi-miio plugin. Add the "pollingInterval" option: 3000 to config to reduce the frequency of the device's survey.

Method 3: Alternative bridges (for Zigbee lamps)

If your Xiaomi lamp is running on the Zigbee protocol (e.g. Mi) LED Smart Bulb (Zigbee), it can be connected to HomeKit via:

• 🌉 Zigbee2MQTT + Home Assistant (recommended).
• 🔌 Branded hubs with alternative firmware (for example, CC2531 + Z-Stack).
• 🍎 Prefabricated bridges like the Aqara Hub (limited support).

For Zigbee2MQTT need:

1. USB-adapter CC2531 or ConBee II (~1500–3000 ₽).
2. Installed Zigbee2MQTT (instruction).
3. Integration with Home Assistant or HomeBridge

Once set up, the lamp will be available in HomeKit as a standard Lightbulb device with support for:

• 🎨 Colour adjustments (HSV).
• 🔆 Brightness (Brightness).
• 🔄 Automation through Shortcuts or Automation in the Home.

⚠️ Attention: When in use Zigbee2MQTT Avoid connecting the lamp to the Xiaomi Gateway hub at the same time, which will lead to a network conflict.

5. Typical errors and their solutions

Even with the right setup, users face problems. Consider the most common:

If the lamp connects but does not maintain a state (for example, after turning off the socket), add a parameter to the HomeBridge configuration:

"restoreState": true

For Home Assistant, a similar setting is in the Xiaomi Miio integration configuration file.

6. Comparison of methods: which one to choose?

The choice of integration method depends on your technical skills and available equipment:

• 🏆 Home Assistant is the best option for experienced users who are ready to configure the server.
• 🖥️ HomeBridge – suitable for those who have always enabled Mac or Raspberry Pi. Cons: dependence on the Xiaomi cloud (without local plugins).
• 🌉 Zigbee2MQTT — It requires the purchase of an adapter, but gives you full control.

If you’re new to the servers, consider buying native-supported HomeKit bulbs (like Philips Hue or Nanoleaf), but for Xiaomi owners, Home Assistant integration remains the most flexible solution.

💡

For maximum stability, use the Home Assistant. + Zigbee2MQTT (for Zigbee lamps or Home Assistant + Xiaomi Miio (for Wi-Fi lamps).

7. Additional features after connection

After successfully integrating the lamp into HomeKit, you can:

• 🎬 Create scenes (for example, "Cinema" with dimmed lights).
• ⏰ Adjust automation by time or geolocation (turn on lights when returning home).
• 🎤 Manage your voice through Siri (Hey Siri, turn off the lights in the living room").
• 📱 Use Shortcuts for complex scenarios (e.g. flashing a lamp when notifying you).

Example of automation in HomeKit:

1. Open the Home app on your iPhone.
2. Go to the Automation tab → Create automation.
3. Select a trigger (e.g., “People are coming”).
4. Add the "Accessories Control" action and select the lamp.
5. Set the parameters (color, brightness) and save.

For advanced users: In Home Assistant, you can create a script that will gradually change the color of the lamp depending on the time of day (for example, warm light in the evening and cold in the afternoon).

FAQ: Frequent questions