Repolode
Submit
Koenkk

Koenkk/zigbee2mqtt

A bridge that connects Zigbee smart home devices to MQTT, so they work without the vendor's own hub or gateway.

Open-source alternative to:Philips Hue Bridge

View on GitHubWebsite
Stars
15,755
Forks
2,029
Open issues
487
Last commit
3 days ago

What is it?

Zigbee2MQTT talks to a Zigbee coordinator adapter directly and republishes device events and state over MQTT. Users can control Zigbee lights, sensors, switches and other devices through MQTT topics, which lets them connect Zigbee hardware to whatever home automation system already speaks MQTT.

The project is built in TypeScript and runs as a service on a host with a supported Zigbee adapter. It is split into three layers: zigbee-herdsman handles adapter communication, zigbee-herdsman-converters maps device models to their Zigbee clusters, and Zigbee2MQTT itself translates between Zigbee messages and MQTT. It includes web-based interfaces for monitoring and configuration.

Support for a device is maintained through a published list of compatible hardware, and new devices can be added by writing converter code. Official integrations are documented for Home Assistant, Homey, Domoticz, Gladys Assistant and ioBroker.

Key features

  • 01Controls Zigbee devices by publishing and subscribing to MQTT topics.
  • 02Works without a vendor-specific Zigbee bridge or gateway.
  • 03Ships with web interfaces for monitoring and configuring the network.
  • 04Maintains a public list of supported devices from many vendors.
  • 05Offers documented integrations with Home Assistant, Homey, Domoticz and others.

Use cases

  • Running a local smart home that avoids cloud-only vendor hubs.
  • Feeding Zigbee sensor readings into an existing MQTT-based automation system.
  • Adding unsupported-by-vendor Zigbee devices to Home Assistant or similar platforms.

Quick start

  1. 1

    Follow the Getting started guide in the official documentation

Things to know

  • Licensed under GPL-3.0, a copyleft license that requires derivative works to be open-sourced under the same terms.
  • Not every Zigbee device is supported, so unlisted devices may need new support added.

Topics

#zigbee#mqtt#iot#smart-home#home-automation#typescript#hacktoberfest

FAQ

What is zigbee2mqtt?
A bridge that connects Zigbee smart home devices to MQTT, so they work without the vendor's own hub or gateway. Zigbee2MQTT talks to a Zigbee coordinator adapter directly and republishes device events and state over MQTT. Users can control Zigbee lights, sensors, switches and other devices through MQTT topics, which lets them connect Zigbee hardware to whatever home automation system already speaks MQTT.
Is zigbee2mqtt free to use? What license does it have?
zigbee2mqtt is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is zigbee2mqtt still maintained?
Actively maintained. The last commit to zigbee2mqtt was on Oct 21, 2026.
What can I use zigbee2mqtt for?
Running a local smart home that avoids cloud-only vendor hubs. Feeding Zigbee sensor readings into an existing MQTT-based automation system. Adding unsupported-by-vendor Zigbee devices to Home Assistant or similar platforms.
How do I install zigbee2mqtt?
Follow the Getting started guide in the official documentation
Where can I get zigbee2mqtt?
The source code and installation instructions are on GitHub: https://github.com/Koenkk/zigbee2mqtt

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects