# Zigbee2MQTT

Zigbee 🐝 to MQTT bridge 🌉, get rid of your proprietary Zigbee bridges 🔨

Repository: https://github.com/Koenkk/zigbee2mqtt
Canonical: https://ross.abutalabs.com/products/zigbee2mqtt
Homepage: https://www.zigbee2mqtt.io
Language: TypeScript
License: GPL-3.0
License Family: copyleft
Topics: hacktoberfest
Last push: 2026-08-26T10:17:17+00:00
Link (homepage): https://www.zigbee2mqtt.io
Link (site_page): https://www.zigbee2mqtt.io/guide/getting-started
Link (site_page): https://www.zigbee2mqtt.io/guide/installation
Link (site_page): https://www.zigbee2mqtt.io/guide/faq

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 95, longevity 100
- inputs: {"age_days": 3069, "days_push": 7, "days_rel": 32, "gap_med": 28, "n_releases_24m": 32}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 15574, forks 1996 (observed 2026-08-28T04:11:12.205927+00:00)

## What it is
Zigbee2MQTT is a Node.js application that bridges Zigbee devices to MQTT, letting you control Zigbee sensors, bulbs, and switches without the vendor's proprietary bridge or gateway. It supports a wide range of Zigbee USB/GPIO/network adapters and integrates with home automation platforms like Home Assistant via MQTT.

## Use cases
- control zigbee devices without the vendor bridge
- integrate zigbee sensors with home assistant
- bridge zigbee to mqtt broker
- replace philips hue or xiaomi gateway
- pair and manage zigbee devices from a raspberry pi
- get zigbee device state and events over mqtt topics
- run a self-hosted zigbee coordinator

## When to choose
- you want vendor-independent control of Zigbee devices
- your smart home setup already uses MQTT (Home Assistant, openHAB, Node-RED)
- you want to run on a Raspberry Pi, Docker, or Home Assistant addon
- you need broad device support with OTA updates, groups, and bindings

## When to avoid
- you need Zigbee over IP/LAN - the coordinator must be locally attached or network-serial
- you want a plug-and-play commercial hub with no configuration
- you need multiple Zigbee networks from one instance - each instance supports a single coordinator

## Facets
- artifact type: application
- maturity: stable
- function: iot, message-queue, workflow-automation, developer-tools
- domain: iot, self-hosted
- platform: windows, self-hosted, cross-platform
- tags: zigbee, mqtt, smart-home, home-assistant, iot-bridge, zigbee-adapter, home-automation, automation, linux, macos, docker, nodejs

## Member repositories
- Koenkk/zigbee2mqtt (main) score 98
- Koenkk/zigbee-herdsman-converters (plugin) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:12.205927+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:05:38.906859+00:00, confidence not recorded.
  - readme: https://github.com/Koenkk/zigbee2mqtt (fetched 2026-08-28T04:11:12.205927+00:00, sha 7d0afa4e9142)
  - homepage: https://www.zigbee2mqtt.io (fetched 2026-08-29T08:04:25.479471+00:00, sha 7586ccffe9b9)
  - site_page: https://www.zigbee2mqtt.io/guide/getting-started (fetched 2026-08-29T08:04:25.489930+00:00, sha a5e7cbf8776e)
  - site_page: https://www.zigbee2mqtt.io/guide/installation (fetched 2026-08-29T08:04:25.492368+00:00, sha 8bacf9cd1e1b)
  - site_page: https://www.zigbee2mqtt.io/guide/faq (fetched 2026-08-29T08:04:25.494316+00:00, sha 192bb5c8d703)
  - registry_npm: https://registry.npmjs.org/zigbee2mqtt (fetched 2026-08-29T08:04:25.496690+00:00, sha 832cef930d91)
- Data as of 2026-08-30T08:39:29.467469+00:00.