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

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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
Instructions
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