DeConz MCP Server

MCP Server for deConz server developed by Dresden Elektronik (bridge between smart home automation platforms and wireless Zigbee networks)

Local serverstdioPython

What is the DeConz MCP Server?

MCP Server for deConz server developed by Dresden Elektronik (bridge between smart home automation platforms and wireless Zigbee networks)

What you get

Supports stdio, SSE, and Streamable HTTP transports. HTTP transports are protected by a configurable bearer token.

Configuration and credentials

  • Python ≥ 3.10 - uv (recommended) or pip - A running deCONZ / Phoscon gateway with a ConBee or RaspBee adapter - A valid deCONZ REST API key (see Obtaining an API key) ---

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
configure_deconzPoint the server at a deCONZ gateway at runtime (host, port, API key). Registered only when the gateway is not configured from the environment, or when DECONZ_A
get_gateway_configRead gateway name, firmware, Zigbee channel, IP, WebSocket port
set_permit_joinOpen the Zigbee network for new device pairing (0–255 seconds)
list_lightsList all lights with on/off, brightness, and reachability
get_lightFull JSON details for a single light
set_light_stateControl power, brightness, hue, saturation, colour temp, xy, effect, alert
rename_lightRename a light
delete_lightRemove a light from the gateway
list_groupsList all groups with member count and action state
get_groupFull JSON details for a single group
create_groupCreate a new group (optionally pre-populate with lights)
set_group_actionControl all lights in a group simultaneously
modify_groupRename a group or change its member lights
delete_groupDelete a group (lights remain)
list_scenesList all scenes for a group
get_sceneFull JSON details for a scene
create_sceneCreate a scene (captures current group state)
recall_sceneActivate a scene
store_sceneOverwrite a scene with the current group state
rename_sceneRename a scene
delete_sceneDelete a scene
list_sensorsList all sensors with latest readings and battery levels
get_sensorFull JSON details for a single sensor
rename_sensorRename a sensor
set_sensor_configUpdate sensor config (enabled, battery level, sensitivity)
delete_sensorRemove a sensor from the gateway
list_rulesList all automation rules with status and trigger counts
get_ruleFull JSON details (conditions + actions) for a rule
create_ruleCreate a new rule with conditions and actions
set_rule_statusEnable or disable a rule
delete_ruleDelete a rule
list_schedulesList all timed schedules
get_scheduleFull JSON details for a schedule
create_scheduleCreate a new schedule with ISO 8601 time expression
set_schedule_statusEnable or disable a schedule
delete_scheduleDelete a schedule
touchlink_scanStart a Touchlink scan (~10 s) to find nearby Zigbee devices
get_touchlink_resultsReturn results from the last Touchlink scan
touchlink_identifyMake a Touchlink device blink for identification
touchlink_resetFactory-reset a Touchlink device

How to install the DeConz MCP Server

{
  "mcpServers": {
    "deconz": {
      "command": "deconz-mcp",
      "env": {
        "DECONZ_HOST": "192.168.1.10",
        "DECONZ_API_KEY": "YOUR_DECONZ_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python ≥ 3.10 - uv (recommended) or pip - A running deCONZ / Phoscon gateway with a ConBee or RaspBee adapter - A valid deCONZ REST API key (see Obtaining an API key) ---
VariableDescriptionRequired
DECONZ_HOSTDeclared in the maintainer’s client configuration.Check documentation
DECONZ_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use DeConz MCP to Category.”
  • “Use DeConz MCP to Config.”
  • “Use DeConz MCP to Lights.”

Frequently asked questions

MCP Server for deConz server developed by Dresden Elektronik (bridge between smart home automation platforms and wireless Zigbee networks) Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.