Zigbee2mqtt MCP
Administer a Zigbee2MQTT estate: health, mesh diagnostics, OTA, pairing, device…
- 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-mcpAdd 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.RequiredZ2M_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.