io.github.alexpfau/zigbee2mqtt-mcp MCP Server

Name: io.github.alexpfau/zigbee2mqtt-mcp MCP Server
Author: io.github.alexpfau

io.github.alexpfau/zigbee2mqtt-mcp

Repository Registry

What is the io.github.alexpfau/zigbee2mqtt-mcp MCP server?

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

How to install io.github.alexpfau/zigbee2mqtt-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zigbee2mqtt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp"
      ],
      "env": {
        "Z2M_MQTT_URL": "<YOUR_Z2M_MQTT_URL>",
        "Z2M_MQTT_USERNAME": "<YOUR_Z2M_MQTT_USERNAME>",
        "Z2M_MQTT_PASSWORD": "<YOUR_Z2M_MQTT_PASSWORD>",
        "Z2M_BASE_TOPIC": "<YOUR_Z2M_BASE_TOPIC>",
        "Z2M_WRITE_MODE": "<YOUR_Z2M_WRITE_MODE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "zigbee2mqtt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp"
      ],
      "env": {
        "Z2M_MQTT_URL": "<YOUR_Z2M_MQTT_URL>",
        "Z2M_MQTT_USERNAME": "<YOUR_Z2M_MQTT_USERNAME>",
        "Z2M_MQTT_PASSWORD": "<YOUR_Z2M_MQTT_PASSWORD>",
        "Z2M_BASE_TOPIC": "<YOUR_Z2M_BASE_TOPIC>",
        "Z2M_WRITE_MODE": "<YOUR_Z2M_WRITE_MODE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zigbee2mqtt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp"
      ],
      "env": {
        "Z2M_MQTT_URL": "<YOUR_Z2M_MQTT_URL>",
        "Z2M_MQTT_USERNAME": "<YOUR_Z2M_MQTT_USERNAME>",
        "Z2M_MQTT_PASSWORD": "<YOUR_Z2M_MQTT_PASSWORD>",
        "Z2M_BASE_TOPIC": "<YOUR_Z2M_BASE_TOPIC>",
        "Z2M_WRITE_MODE": "<YOUR_Z2M_WRITE_MODE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "zigbee2mqtt-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp"
      ],
      "env": {
        "Z2M_MQTT_URL": "<YOUR_Z2M_MQTT_URL>",
        "Z2M_MQTT_USERNAME": "<YOUR_Z2M_MQTT_USERNAME>",
        "Z2M_MQTT_PASSWORD": "<YOUR_Z2M_MQTT_PASSWORD>",
        "Z2M_BASE_TOPIC": "<YOUR_Z2M_BASE_TOPIC>",
        "Z2M_WRITE_MODE": "<YOUR_Z2M_WRITE_MODE>"
      }
    }
  }
}

Claude Code

claude mcp add zigbee2mqtt-mcp --env Z2M_MQTT_URL=<YOUR_Z2M_MQTT_URL> --env Z2M_MQTT_USERNAME=<YOUR_Z2M_MQTT_USERNAME> --env Z2M_MQTT_PASSWORD=<YOUR_Z2M_MQTT_PASSWORD> --env Z2M_BASE_TOPIC=<YOUR_Z2M_BASE_TOPIC> --env Z2M_WRITE_MODE=<YOUR_Z2M_WRITE_MODE> -- npx -y zigbee2mqtt-mcp