Skip to content
MCP server

Zigbee2mqtt MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.7.0
Listing updated
6 days ago

About Zigbee2mqtt MCP

Zigbee2mqtt MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • Z2M_MQTT_URLMQTT 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.Required
  • Z2M_MQTT_USERNAMEMQTT broker username, if the broker requires authentication.
  • Z2M_MQTT_PASSWORDMQTT broker password, if the broker requires authentication.
  • Z2M_BASE_TOPICZigbee2MQTT base topic. Must match mqtt.base_topic in configuration.yaml. Defaults to zigbee2mqtt.
  • Z2M_WRITE_MODETool 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).

Pricing

Open source

Zigbee2mqtt MCP FAQ

Is Zigbee2mqtt MCP free?

Yes. Zigbee2mqtt MCP is open source, so you can use and self-host it for free.

How do I add Zigbee2mqtt MCP to Claude Code?

Run this command in your terminal: claude mcp add zigbee2mqtt-mcp --env Z2M_MQTT_URL='<Z2M_MQTT_URL>' --env Z2M_MQTT_PASSWORD='<Z2M_MQTT_PASSWORD>' -- npx -y zigbee2mqtt-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers