zigbee2mqtt-mcp
CommunityMCP server by alexpfau · updated · ★ 32 · 72 downloads a week
Administer a Zigbee2MQTT estate: health, mesh diagnostics, OTA, pairing, device management. zigbee2mqtt-mcp is a community project by alexpfau, not verified by a company domain.
Last commit 6 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
Z2M_Environment variable, secret | Required | 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_Environment variable | Optional | MQTT broker username, if the broker requires authentication. |
Z2M_Environment variable, secret | Optional | MQTT broker password, if the broker requires authentication. |
Z2M_Environment variable | Optional | Zigbee2MQTT base topic. Must match mqtt.base_topic in configuration.yaml. Defaults to zigbee2mqtt. |
Z2M_Environment variable | Optional | 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). |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install zigbee2mqtt-mcp
Built from the published package, never by AIclaude mcp add zigbee2mqtt-mcp -e Z2M_MQTT_URL=YOUR_Z2M_MQTT_URL -- npx -y zigbee2mqtt-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"zigbee2mqtt-mcp": {
"command": "npx",
"args": [
"-y",
"zigbee2mqtt-mcp"
],
"env": {
"Z2M_MQTT_URL": "YOUR_Z2M_MQTT_URL"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"zigbee2mqtt-mcp": {
"command": "npx",
"args": [
"-y",
"zigbee2mqtt-mcp"
],
"env": {
"Z2M_MQTT_URL": "YOUR_Z2M_MQTT_URL"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"zigbee2mqtt-mcp": {
"command": "npx",
"args": [
"-y",
"zigbee2mqtt-mcp"
],
"env": {
"Z2M_MQTT_URL": "YOUR_Z2M_MQTT_URL"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add zigbee2mqtt-mcp --env Z2M_MQTT_URL=YOUR_Z2M_MQTT_URL -- npx -y zigbee2mqtt-mcp{
"mcpServers": {
"zigbee2mqtt-mcp": {
"command": "npx",
"args": [
"-y",
"zigbee2mqtt-mcp"
],
"env": {
"Z2M_MQTT_URL": "YOUR_Z2M_MQTT_URL"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add zigbee2mqtt-mcp npx -y zigbee2mqtt-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the zigbee2mqtt-mcp block.
Weekly newsletter
Like zigbee2mqtt-mcp? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to zigbee2mqtt-mcp
All alternatives →Streamlined AI CLI orchestration engine with mathematical rigor and enterprise-grade reliability
Local-first Apple Health MCP server for questions about your sleep, workouts and heart data.
An MCP server that provides CodeScene Code Health analysis tools.
IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools.
Executable mathematics and independent verification for AI agents.
MCP management console for the official DeepSeek Harness MCP client: /mcp command with health diagnostics and pipeline trial calls, a Settings MCP tab with server CRUD (append-only profile-patch fragments, approval-gated writes with automatic backups), a
zigbee2mqtt-mcp: common questions
How do I install zigbee2mqtt-mcp?
In Claude Code run claude mcp add zigbee2mqtt-mcp -e Z2M_MQTT_URL=YOUR_Z2M_MQTT_URL -- npx -y zigbee2mqtt-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is zigbee2mqtt-mcp the official server?
zigbee2mqtt-mcp is a community project by alexpfau, not verified by a company domain.
Is zigbee2mqtt-mcp free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is zigbee2mqtt-mcp safe to use?
It scores 73 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to zigbee2mqtt-mcp?
Similar MCP servers: Jay Code, Apple Health, codescene-mcp-server, IBGE Brasil MCP.
Does zigbee2mqtt-mcp work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
