Zigbee2MQTT
homebridge-z2m · v1.11.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
| Device | Status | What they said | Source |
|---|---|---|---|
| Aqara door and window sensors | Works | Works via Homebridge with a Zigbee stick and zigbee2mqtt instead of Aqara hubSaved copyYou 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 sensors | Works | Suggested via Zigbee2MQTT for outdoor temperature and humiditySaved copyAqara 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 devices | Works | Works with Aqara sensors and outlet; Aqara notifications lostSaved copyI 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 Zigbee2MQTT | Works | Aqara sensors and buttons work great via z2m pluginSaved copyI'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 purifier | Works | Only air quality at first; fan support added later after owner workaroundSaved 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 Repeater | Works | Works as Zigbee router/extenderSaved copyThe IKEA TRÅDFRI Signal repeater works. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2023-11 |
| Lidl Silvercrest Zigbee devices | Works | Plugin author uses several Lidl Zigbee devices via a supported Zigbee adapterSaved copyHi. 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 bulbs | Works | Work well via Zigbee2MQTT with TI development kit coordinatorSaved copyA 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 dimmer | Works | Bound to Miboxer LED controller via Zigbee binding; on/off and brightness linked at device levelSaved 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 dongle | Works | Zigbee2MQTT supports it for Aqara and Hue devices in HomebridgeSaved copyZigbee2MQTT supports it I think Excerpt saved from Arctic Shift Reddit archive on 2026-10-22. | Reddit comment · 2025-02 |
| Tuya PJ-ZGD01 garage door module | Works | Support request closed as completedSaved copyDevice 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 detectors | Works | Motion, temp/humidity, vibration and smoke detectors work great via Z2MSaved copyI 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 module | Works | Works reliably via zigbee dongle and zigbee2mqtt; Yale Connect hub poorSaved copyI 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 Zigbee2MQTT | Works | Switched from deCONZ; lights respond much fasterSaved copyUpdate: 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 zigbee2mqtt | Works | Sonoff USB stick with z2m works with Aqara, Mi, Sonoff, Ikea, Ledvance, Hue devicesSaved copyGo 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 devices | Works | Plugin author uses it; new devices added quicklySaved copyI'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 sensor | Partly works | Vibration/moving not reported; motion service discussedSaved copyAh - 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) | Requested | Loads but needs exposes data; closed staleSaved copyPlease 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) | Requested | Thermostat support not yet in plugin at the timeSaved copyigbeeModel: ['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 gateway | Won’t be supported | Lidl gateway not supported; use a Zigbee2MQTT-supported adapter insteadSaved copyLidl 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 lock | Won’t be supported | Not exposed as typical lock in Z2M; not supportedSaved copyI 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 Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20.18.0 || ^22.10.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | zigbee2mqtt |
| License | Apache-2.0 |
Community signals
| Downloads a week | 140 |
|---|---|
| Downloads a month | 648 |
| GitHub stars | 383 |
| Open issues | 8 |
| Closed issues | 240 |
| Discussions | 15 |
| Last code push | 2026-10-21 |
| Latest version | 1.11.0 (2026-03-29) |
| First published | 2020-06-30 |
| Releases | 50 |
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
Sources
- npm: https://www.npmjs.com/package/homebridge-z2m
- Source code: https://github.com/itavero/homebridge-z2m
- Issues: https://github.com/itavero/homebridge-z2m/issues
- Homepage: https://z2m.dev
- Verified plugins list: https://github.com/homebridge/verified





