Zigbee2mqtt MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add zigbee2mqtt-mcp -e 'Z2M_MQTT_URL=<Z2M_MQTT_URL>' -- npx -y zigbee2mqtt-mcp

{
  "mcpServers": {
    "zigbee2mqtt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp"
      ],
      "env": {
        "Z2M_MQTT_URL": "<Z2M_MQTT_URL>"
      }
    }
  }
}

[mcp_servers.zigbee2mqtt-mcp]
command = "npx"
args = ["-y", "zigbee2mqtt-mcp"]
env = { Z2M_MQTT_URL = "<Z2M_MQTT_URL>" }

{
  "mcpServers": {
    "zigbee2mqtt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp"
      ],
      "env": {
        "Z2M_MQTT_URL": "<Z2M_MQTT_URL>"
      }
    }
  }
}

{
  "servers": {
    "zigbee2mqtt-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zigbee2mqtt-mcp"
      ],
      "env": {
        "Z2M_MQTT_URL": "<Z2M_MQTT_URL>"
      }
    }
  }
}

Put your own value in place of <Z2M_MQTT_URL> (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). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: Z2M_MQTT_USERNAME (MQTT broker username, if the broker requires authentication), Z2M_MQTT_PASSWORD (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)).