Schema | Domoticz MCP Server

Domoticz MCP Server

Overview Schema Related Servers Score Discussions

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`DOMOTICZ_URL`	Yes	Base URL of your Domoticz instance
`DOMOTICZ_MCP_HOST`	No	Host to bind to for SSE/HTTP	127.0.0.1
`DOMOTICZ_MCP_PORT`	No	Port to bind to for SSE/HTTP	8000
`DOMOTICZ_PASSWORD`	No	Your Domoticz password for Basic Auth
`DOMOTICZ_USERNAME`	No	Your Domoticz username for Basic Auth
`DOMOTICZ_CLIENT_ID`	No	Your Application's Client ID for OAuth
`DOMOTICZ_OAUTH_TOKEN`	No	Direct OAuth2 access token (skips flow)
`DOMOTICZ_CLIENT_SECRET`	No	Your Application's Client Secret for OAuth
`DOMOTICZ_MCP_TRANSPORT`	No	Transport to use: stdio, sse, or streamable-http	stdio
`DOMOTICZ_MCP_TOKEN_FILE`	No	Path to OAuth token storage file	~/.config/domoticz-mcp/token.json

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Tools

Functions exposed to the LLM to take actions

Name	Description
start_oauth_login	Start or reuse a bounded browser login. Open the returned URL, then poll get_oauth_login_status.
get_oauth_login_statusA	Check a browser login. Retry the original operation only after status is complete.
search_scripts_tool	Search string in scripts. Cross-ref: `domoticz://events`.
search_devices_tool	Search devices by name/status. Cross-ref: `domoticz://devices`.
get_daily_energy_history	Read today's counter history. Preferred: `idx`. Set `include_instantaneous=False` for daily totals.
get_weekly_energy_history	Read the last 7 days of counter history. Preferred: `idx`.
get_monthly_energy_history	Read this month's counter history. Preferred: `idx`.
toggle_switch	Toggle device. Preferred: `idx`. Cross-ref: `set_switch_state`.
set_switch_state	Set 'On'/'Off'. Preferred: `idx`. Cross-ref: `toggle_switch`.
set_dimmer_levelA	Set brightness (0-100). Preferred: `idx`. Cross-ref: `domoticz://device/{idx}`.
set_temperature_setpoint	Set target temp. Preferred: `idx`.
control_blinds	'Open'/'Close'/'Stop'. Preferred: `idx`.
switch_scene	Activate scene. 'On'/'Off'/'Toggle'. Preferred: `idx`. Cross-ref: `domoticz://scenes`.
add_user_variableC	Add var. vtype: 0=Int, 1=Float, 2=Str, 3=Date, 4=Time. Cross-ref: `domoticz://user-variables`.
update_user_variableB	Update var value. Cross-ref: `domoticz://user-variables`.
delete_user_variableA	Delete var. Preferred: `idx`. Requires `confirm=True`.
create_eventC	Create script. Cross-ref: `domoticz://docs/dzvents_syntax`.
update_eventC	Update script. Cross-ref: `domoticz://event/{event_id}`. Requires `confirm=True`.
call_domoticz_api	Raw API call. Use if dedicated tools fail. Requires `confirm=True`.
restart_system	Reboot server. Requires `confirm=True`.
rename_device	Rename device. Preferred: `idx`.
delete_device	Hide device. Preferred: `idx`. Requires `confirm=True`.
create_virtual_sensor	Create dummy. Cross-ref: `domoticz://hardware`.
update_device_value	Manual update. Preferred: `idx`.
add_log_message	Log message. level: 1=Normal, 2=Status, 4=Error. Cross-ref: `domoticz://logs`.
send_notification	Send notification.
set_security_status	Arm panel. 0=Disarm, 1=Home, 2=Away. Requires `confirm=True`. Cross-ref: `domoticz://security`.
set_color_brightness	Set RGB. Preferred: `idx`.
set_color_temperature	Set normalized white temperature (0-100). Preferred: `idx`.

Prompts

Interactive templates invoked by user choice

Name	Description
`agent_guidance`	Expert rules. ORIENTATION: Read `domoticz://overview`.
`maintenance_report`	Health summary. Cross-refs: `domoticz://health`, `domoticz://battery-alerts`, `domoticz://logs/error`.
`summarize_home`	State summary. Cross-ref: `domoticz://dashboard`.
`energy_audit`	Usage analysis. Cross-ref: `domoticz://devices`.

Resources

Contextual data attached and managed by the client

Name	Description
`get_overview_resource`	Orientation: system version, hardware, and device counts.
`get_system_health_resource`	Troubleshooting: hardware health and unresponsive devices.
`get_all_devices_resource`	Large output: state of all Domoticz devices.
`get_scenes_resource`	List: configured scenes and groups.
`get_rooms_resource`	List: Room Plans (logical groupings).
`get_user_variables_resource`	System: current values of user-defined variables.
`get_battery_levels_resource`	Maintenance: devices with <= 20% battery.
`get_events_resource`	Overview: internal event system scripts.
`get_hardware_resource`	System: configured hardware gateways.
`get_dashboard_resource`	Curated: favorite and active devices status.
`get_log_resource`	Debug: recent system logs.
`get_log_alias_resource`	Alias: recent system logs.
`get_error_logs_resource`	Debug: only 'Error' level log entries.
`get_security_resource`	Status: security panel arming state.
`get_settings_resource`	Config: global system settings.
`get_dzvents_docs`	Rules: dzVents automation syntax.
`get_blockly_docs`	Rules: Blockly XML representation.

Server Configuration
Capabilities
Tools
Prompts
Resources

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/adrighem/domoticz-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server