alexpfau/zigbee2mqtt-mcp

Overview

MCP server for administering a Zigbee2MQTT estate. It provides health reporting, mesh diagnostics, OTA updates, pairing, binding and device options through the MQTT bridge API. Written in TypeScript.

Best for

Best for
Developers managing Zigbee2MQTT networks through MCP-enabled AI assistants

Use cases

• Monitor Zigbee network health and mesh diagnostics
• Trigger OTA firmware updates for devices
• Pair, bind and configure device options

How to use

Install

npx zigbee2mqtt-mcp

Tools exposed

• Z2M_MQTT_URL
• Z2M_BASE_TOPIC
• Z2M_MQTT_CLIENT_ID
• Z2M_WRITE_MODE
• Z2M_LOG_LEVEL
• Z2M_WEAK_LINK_THRESHOLD
• Z2M_LOW_BATTERY_THRESHOLD
• Z2M_STALE_HOURS
• Z2M_CONNECT_TIMEOUT_MS
• Z2M_REQUEST_TIMEOUT_MS
• Z2M_MQTT_REJECT_UNAUTHORIZED
• z2m_connection_status
• z2m_bridge_info
• z2m_list_devices
• z2m_get_device
• z2m_health_report
• z2m_network_map
• z2m_list_groups
• z2m_get_logs
• z2m_coordinator_check

Tested with

Claude Desktop, VS Code

Notes

MCP server for administering a Zigbee2MQTT estate. It provides health reporting, mesh diagnostics, OTA updates, pairing, binding and device options through the MQTT bridge API. Written in TypeScript.

29 stars on GitHub. Last updated 2026-08-28. Licensed MIT.

Use cases

• Monitor Zigbee network health and mesh diagnostics
• Trigger OTA firmware updates for devices
• Pair, bind and configure device options

Pros

• Covers a wide range of Zigbee2MQTT admin tasks in one server
• Uses the standard MQTT bridge API, no custom hardware needed
• TypeScript codebase for easier contribution

Cons

• Small community with 29 GitHub stars
• Requires a running Zigbee2MQTT instance and MQTT bridge access
• Feature set limited to what the bridge API exposes

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.