HomeOther › zigbee2mqtt-mcp

zigbee2mqtt-mcp

Administer a Zigbee2MQTT estate: health, mesh diagnostics, OTA, pairing, device management.

TypeScript Local macOSWindowsLinux
★ 31 stars Last pushed 2026-09-18 License: MIT

Topics: Home Automation

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.7.0)

npx -y zigbee2mqtt-mcp@0.7.0

Or add to your MCP client config:

{
  "mcpServers": {
    "zigbee2mqtt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp@0.7.0"
      ],
      "env": {
        "Z2M_MQTT_URL": "<YOUR_VALUE>",
        "Z2M_MQTT_USERNAME": "<YOUR_VALUE>",
        "Z2M_MQTT_PASSWORD": "<YOUR_VALUE>",
        "Z2M_BASE_TOPIC": "<YOUR_VALUE>",
        "Z2M_WRITE_MODE": "<YOUR_VALUE>"
      }
    }
  }
}
  • Z2M_MQTT_URL required secret — MQTT broker URL used by Zigbee2MQTT, e.g. mqtt://192.168.1.10:1883. Supports mqtt://, mqtts://, ws:// and wss://. This is the broker, not the Zigbee2MQTT frontend port.
  • Z2M_MQTT_USERNAME — MQTT broker username, if the broker requires authentication.
  • Z2M_MQTT_PASSWORD secret — MQTT broker password, if the broker requires authentication.
  • Z2M_BASE_TOPIC — Zigbee2MQTT base topic. Must match mqtt.base_topic in configuration.yaml. Defaults to zigbee2mqtt.
  • Z2M_WRITE_MODE — Tool exposure tier: off (read-only), safe (default; adds non-destructive writes such as pairing, options, rename and binding) or full (adds device removal, OTA flashing, Touchlink and bridge restart).

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry