Skip to content
Homebridge TestFlight
Xiaomi, Aqara, Philips Hue

Zigbee2MQTT

homebridge-z2m · v1.11.0

VerifiedLocalHomebridge 2.0

Adds Zigbee devices to HomeKit via Zigbee2MQTT and an MQTT broker.

What it says it supports

Brands

  • Xiaomi
  • Aqara
  • Philips Hue
  • IKEA Tradfri
  • Tuya
  • Osram
  • Innr
  • Gledopto

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Users request specific Zigbee2MQTT devices; the owner adds support when exposes data is supplied. Locks and some fans were initially unsupported.

  • Works16
  • Partly works1
  • Requested2
  • Won’t be supported2
DeviceStatusWhat they saidSource
Aqara door and window sensorsWorksWorks via Homebridge with a Zigbee stick and zigbee2mqtt instead of Aqara hub
Saved copy
You need their hub to connect the sensors to HomeKit natively, but you don't need it if you are going to be using them through Homebridge. You'll just need Homebridge zigbee to MQTT or something like that, I'm not very familiar with Homebridge and Zigbee, And a Zigbee stick. The sensor will pair to the Zigbee stick then.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2024-02
Aqara temperature sensorsWorksSuggested via Zigbee2MQTT for outdoor temperature and humidity
Saved copy
Aqara sensors, they can be added to Homebridge and other smarthome applications with Zigbee2MQTT

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2024-08
CC2531 Zigbee adapter with Aqara devicesWorksWorks with Aqara sensors and outlet; Aqara notifications lost
Saved copy
I use a CC2531 antenna plugged in a Pi, with zigbee2mqtt and homebridge-z2m. I only do automations with the Home app, most of them converted into Shortcuts. Some niche ones (Aqara Outlet, need watt usage), I use Home+ because Eve is ugly. Say goodbye to Aqara notifications (and know that you can have better ones with dummy plugins and such). I don't see any advantages in a bigger mesh. I recently switched my Aqaras, some Hues, some Ikeas and Sonoffs to one gateway solution and I'm thinking of stepping back a bit.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2021-04
ConBee 2 with Zigbee2MQTTWorksAqara sensors and buttons work great via z2m plugin
Saved copy
I've got a Conbee 2 attached to a Synology and *just* got it setup. Like, yesterday. It has been a pain with Phoscon-- never sure what's up-- so installed Zigbee2MQTT in a Docker container, with the z2m HomeBridge plugin doing the translation to HomeKit. A few Aqara sensors and buttons work great, easy to set up. I'll move to Home Assistant soon enough, but this is giving me the minor automation I'm interested in. But it seems you'd lose all of your Hue setups, not sure how you want to talk to them in the end without their hub.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2022-05
IKEA STARKVIND air purifierWorksOnly air quality at first; fan support added later after owner workaround
Saved copy
… the template and fill in all the data requested below! Describe the bug I've installed the latest zigbee2mqtt release 1.22.1 and with this release the IKEA STARKVIND Air Purifier is fully supported and can fully controlled within zigbee2mqtt. https://www.zigbee2mqtt.io/devices/E2007.html#ikea-e2007 It is is not possible to switch the Air Purifier on or off or change the fan mode as only the Air Quality information is displayed in Homebridge Related devices https://www.zigbee2mqtt.io/devices/E2007.html#ikea-e2007 To Reproduce Add device to zigbee2mqtt and try to control the device via …

Excerpt saved from GitHub on 2026-10-22.

Issue #333 · 2021-12
IKEA TRADFRI Signal RepeaterWorksWorks as Zigbee router/extender
Saved copy
The IKEA TRÅDFRI Signal repeater works.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2023-11
Lidl Silvercrest Zigbee devicesWorksPlugin author uses several Lidl Zigbee devices via a supported Zigbee adapter
Saved copy
Hi. The creator of the homebridge-z2m plugin here. I personally use Zigbee2MQTT (as you can imagine) with several devices I bought from Lidl. I do *not* use the Lidl gateway for this, but instead used an Zigbee adapter supported by Zigbee2MQTT to create my Zigbee network. Once Zigbee2MQTT is setup, the homebridge-z2m plugin should make it very easy to also expose these devices to HomeKit via Homebridge. If you do not want to take that route, I believe they're devices are white label Tuya devices, so that might help finding a plugin that knows how to deal with their gateway. However, I'm not …

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2021-03
OSRAM Lightify bulbsWorksWork well via Zigbee2MQTT with TI development kit coordinator
Saved copy
A bit late to the party. I'm using some OSRAM / Lightify devices via Zigbee2MQTT and the homebridge-z2m plugin. It's a very flexible setup in my opinion and works very well. As a Zigbee coordinator I'm using a development kit from Texas Instruments, but there are also simple dongles available for less than 10 USD that work with Zigbee2MQTT.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2021-04
Schneider Odace dimmerWorksBound to Miboxer LED controller via Zigbee binding; on/off and brightness linked at device level
Saved copy
… do this, it works at a device level so you don’t need automations. I found it pretty easy to do with the zigbee2mqtt plugin and homebridge. I’ve got a Schneider odace dimmer directly wired to some spots, but I also bound the on/off state and brightness controls to a miboxer led strip. They work together without any issues.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2024-01
Sonoff Zigbee 3.0 dongleWorksZigbee2MQTT supports it for Aqara and Hue devices in Homebridge
Saved copy
Zigbee2MQTT supports it I think

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2025-02
Tuya PJ-ZGD01 garage door moduleWorksSupport request closed as completed
Saved copy
Device Model Tuya PJ-ZGD01 (Garage door module) Is there an existing issue for this? [x] I have searched the existing issues and did not find an existing issue. Supported by Zigbee2MQTT? [x] Device is supported by Zigbee2MQTT Missing features / functionality In Z2M frontend shown as: Unsupported device - Zigbee2MQTT-Version 2.7.1 Its probably the same model as MatSee Plus PJ-ZGD01 [10.12.2025, 14:40:19] z2m: Configuring 'Z2M_Garagentor' [10.12.2025, 14:40:19] z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/garage/Z2M_Garagentor', payload …

Excerpt saved from GitHub on 2026-10-22.

Issue #1133 · 2025-12
Tuya Zigbee sensors and smoke detectorsWorksMotion, temp/humidity, vibration and smoke detectors work great via Z2M
Saved copy
I use the Aqara motion and contact sensors, and Tuya motion, temperature/humidity and vibration sensors. For smoke detectors I have 1 Aqara and 2 Tuya. They work great with Homebridge via Z2M. Been thinking about the leak detectors, but haven't settled on anything yet -- I'm a bit averse to just leaving stuff on the floor. In terms of aesthetic, the Aqara motion sensors ones look better when stuck to the wall. The Tuya ones are just plastic rectangular boxes - they have a red LED that blinks whenever motion is detected, which I find slightly annoying, however they run of AAA batteries which …

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2024-11
Yale YRD226 lock with Zigbee moduleWorksWorks reliably via zigbee dongle and zigbee2mqtt; Yale Connect hub poor
Saved copy
I have a YRD226, I've started with the zigbee module + "yale connect hub", yales locks are solid and works reliably but the yale connect is total garbage ! The best you can do to optimize your experience is to build a zigbee network with a zigbee usb dongle + mqtt broker + zigbee2mqtt. WIth this setup you just need to install a z2m plugin in your HB instance and setup the lock on you Home App; Also you'll open space for a lot more devices like sensors and switches.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2023-01
Zigbee devices via Zigbee2MQTTWorksSwitched from deCONZ; lights respond much faster
Saved copy
Update: So after testing deCONZ for a day or so I listened to the results of this poll and went with Zigbee2MQTT + homebridge-z2m (thanks u/arno-m for the amazing plugin, frankly this is one of the best written plugins for HB I’ve seen). The results are amazing, my lights took from taking a second to respond when using the IKEA Hub to literally responding while I am still depressing the button - it feels like the traditional non-smart lights in terms of speed. I had issues only with Aqara sensors insisting that they will stay on the coordinator and not using a router but as far as I saw …

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2022-11
Zigbee sensors via zigbee2mqttWorksSonoff USB stick with z2m works with Aqara, Mi, Sonoff, Ikea, Ledvance, Hue devices
Saved copy
Go with option 2, buy a sonoff zigbee usb stick, install zigbee2mqtt and mqtt, and use the homebridge-z2m. I use this, and I have aqara devices, mi devices, sonoff, ikea, ledavance and philips hue without any issues

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2023-01
Zigbee2MQTT devicesWorksPlugin author uses it; new devices added quickly
Saved copy
I'm using Zigbee2MQTT with the homebridge-z2m plugin. But of course, I'm rather biased, as the developer of homebridge-z2m. The reason I decided to make this plugin, is because Zigbee2MQTT has a great community and new devices get added really quick. Initially I used it with Home Assistant, but got tired of having to configure stuff manually in HA as well. So I decided to try and make a plugin that "just works" a long as Zigbee2MQTT is working. I also like the "modularity", meaning that I can easily hook up other applications (i.e. for logging) to the MQTT server as well and have them work …

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2021-08
SmartThings IM6001-MPP01 multi-purpose sensorPartly worksVibration/moving not reported; motion service discussed
Saved copy
Ah - OK. I was basing my comment about Motion Sensor showing up as Occupancy because I'd tested a SmartThings 3325-S motion sensor (2015) model and it exposes 'occupancy' in Zigbee2MQTT and therefore the same in HomeKit. If motion typically is exposed differently then sure it might well make sense to add a motion sensor service to expose the moving event. As clarity by the way - sorry I should have added this to the device support details - The reason I am keen to use this multi-purpose device is that when used in SmartThings (which I am trying to decommission) it gives me the full suite of …

Excerpt saved from GitHub on 2026-10-22.

Issue #264 · 2021-08
SilverCrest SPSZ 3 A1 power strip (TS011F)RequestedLoads but needs exposes data; closed stale
Saved copy
Please use the template and fill in all the data requested below! Device description Product name: Smart USB Extension Lead / Smart Connect Strip Manufacturer: In Z2M: _TZ3000_vmpbygs5, on the device: SilverCrest Model identifier: In Z2M: TS011F, on the device: SPSZ 3 A1 and TY-HG06338-UK Device type : Smart Plug / Power Strip Supported in Zigbee2MQTT? Yes in v1.16: HG06338 Silvercrest 3 gang switch Is this device already supported by Zigbee2MQTT / zigbee-herdsman-converters? Yes in v1.16: HG06338 Silvercrest 3 gang switch https://z2m.dev/devices/lidl/hg06338.html If this is NOT the case, …

Excerpt saved from GitHub on 2026-10-22.

Issue #141 · 2021-04
Tuya TS0601 thermostat radiator valve (Moes HY369RT)RequestedThermostat support not yet in plugin at the time
Saved copy
igbeeModel: ['kud7u2l'], fingerprint: [{modelID: 'TS0601', manufacturerName: '_TZE200_ckud7u2l'}], model: 'TS0601_thermostat', vendor: 'TuYa', description: 'Radiator valve with thermostat', whiteLabel: [{vendor: 'Moes', model: 'HY369RT'}, {vendor: 'SHOJZJ', model: '378RT'}], meta: {tuyaThermostatPreset: tuya.thermostatPresets, tuyaThermostatSystemMode: tuya.thermostatSystemModes3}, ota: ota.zigbeeOTA, onEvent: tuya.onEventSetLocalTime, fromZigbee: [fz.tuya_thermostat, fz.ignore_basic_report, fz.ignore_tuya_set_time], toZigbee: [tz.tuya_thermostat_child_lock, …

Excerpt saved from GitHub on 2026-10-22.

Issue #39 · 2021-01
Lidl Silvercrest Zigbee gatewayWon’t be supportedLidl gateway not supported; use a Zigbee2MQTT-supported adapter instead
Saved copy
Lidl Zigbee hub not supported by Homebridge. You need a different hub.

Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.

Reddit comment · 2021-03
Xiaomi A6121 vima smart lockWon’t be supportedNot exposed as typical lock in Z2M; not supported
Saved copy
I reckon this question is about support for the Xiaomi A6121? As far as I can tell it's not exposed as a typical lock, looking at the device page on the Zigbee2MQTT website. This means that it is not supported by the current `lock` integration, but of course support an probably be added. However, I would need to know what the MQTT messages are that can be expected from this lock and how the related to the Lock Mechanism service and its characteristics in HomeKit. I had a quick look at the Zigbee converter for the device in Koenkk/zigbee-herdsman-converters and I think this will be very …

Excerpt saved from GitHub on 2026-10-22.

Issue #101 · 2021-03

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local

MQTT broker with Zigbee2MQTT

You’ll need

  • Zigbee2MQTT
  • MQTT broker

Compatibility

Verified by HomebridgeYes
Homebridge versions^1.8.0 || ^2.0.0-beta.0
Homebridge 2.0Yes
Node.js^20.18.0 || ^22.10.0 || ^24.0.0
Settings in Homebridge UIYes
MatterNo
Platform namezigbee2mqtt
LicenseApache-2.0

Community signals

Downloads a week140
Downloads a month648
GitHub stars383
Open issues8
Closed issues240
Discussions15
Last code push2026-10-21
Latest version1.11.0 (2026-03-29)
First published2020-06-30
Releases50

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

  • AirQualitySensor
  • Battery
  • CarbonDioxideSensor
  • CarbonMonoxideSensor
  • ContactSensor
  • HumiditySensor
  • LeakSensor
  • LightSensor
  • Lightbulb
  • LockMechanism
  • MotionSensor
  • OccupancySensor
  • Outlet
  • SmokeSensor
  • StatelessProgrammableSwitch
  • Switch
  • TemperatureSensor
  • Thermostat
  • WindowCovering