Zigbee2mqtt MCP

A Model Context Protocol server for administering a Zigbee2MQTT estate. Its README documents 9 tools, including z2m_connection_status, z2m_bridge_info, z2m_list_devices. It runs locally over stdio via the published package.

People connecting automation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-21 · ★ 29 · #28 OF 194 MAINTAINED AUTOMATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Zigbee2mqtt MCP

before you install - you'll need

Set Z2M_MQTT_URL, Z2M_MQTT_USERNAME, Z2M_MQTT_PASSWORD, Z2M_WRITE_MODE before connecting.

Claude Code

claude mcp add alexpfau-zigbee2mqtt-mcp -- npx -y zigbee2mqtt-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "alexpfau-zigbee2mqtt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-08-06 - young repo, little track record yet

license MIT - declared in the repository

npm package zigbee2mqtt-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.alexpfau is GitHub-verified and matches the repo owner

03 · What Zigbee2mqtt MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 9 documented tools, including z2m_connection_status, z2m_bridge_info, z2m_list_devices, z2m_get_device, z2m_health_report.

The 9 tools it gives your agent

Extracted from the project's README - what zigbee2mqtt-mcp lets an agent do.

z2m_connection_status: - Broker reachability, TLS posture and cached message counts - reports instead of throwing, even when nothing is configured yet
z2m_bridge_info: - Version, coordinator, channel, PAN ID, permit_join, restart_required, runtime stats
z2m_list_devices: - Filter and sort devices by type, availability, link quality, battery, pending update
z2m_get_device: - Exposes, settable options, endpoints, bindings, configured reportings, current state
z2m_health_report: - Whole-estate audit in one call
z2m_network_map: - Mesh topology with parent, depth, link quality, orphan detection
z2m_list_groups: - Groups, members and scenes
z2m_get_logs: - Bridge logs and lifecycle events, buffered or watched live
z2m_coordinator_check: - Routers missing from the coordinator's memory (Texas Instruments adapters only)

Latest releases

v0.7.0 · 2026-08-07

v0.6.0 · 2026-08-07

v0.5.0 · 2026-08-07

04 · Who maintains Zigbee2mqtt MCP

zigbee2mqtt-mcp is maintained by alexpfau. It's the only MCP server we track from this author; the repo dates to Aug 2026.

05 · Facts

repository: github.com/alexpfau/zigbee2mqtt-mcp
category: automation - ranked #28 of 194 actively-maintained automation servers as of 2026-08-25.
release cadence: 9 releases in the last 90 days (latest 2026-08-07)
registry: io.github.alexpfau/zigbee2mqtt-mcp (active, first published 2026-08-07 · 7 versions)
packages: npm:zigbee2mqtt-mcp

06 · Zigbee2mqtt MCP FAQ

Is Zigbee2mqtt MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-21 and it shipped 9 releases in the last 90 days. We re-verify nightly.

What can Zigbee2mqtt MCP do?

An agent gets 9 documented tools, including z2m_connection_status, z2m_bridge_info, z2m_list_devices, z2m_get_device, z2m_health_report.

How do I install Zigbee2mqtt MCP?

Run `npx -y zigbee2mqtt-mcp`. The README documents 4 environment variables (Z2M_MQTT_URL, Z2M_MQTT_USERNAME, Z2M_MQTT_PASSWORD…) to set first. Set Z2M_MQTT_URL, Z2M_MQTT_USERNAME, Z2M_MQTT_PASSWORD, Z2M_WRITE_MODE before connecting. You can also paste the ready-made client config above.

Does Zigbee2mqtt MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Zigbee2mqtt MCP

Alternatives to Zigbee2mqtt MCP

Maintained automation servers if Zigbee2mqtt MCP isn't the fit.

More automation MCP servers · Mikro MCP · Anomalia · Mac Use MCP · SYNAPSE CHANNEL · Arr

More TypeScript MCP servers · Contextforge MCP · AlgoVault - Crypto Quant Trade Calls · Vault Cortex · Scope Gate · see all