What are the prerequisites?
A running HomeMatic CCU (debmatic, CCU3, or OpenCCU) reachable on your network, the CCU’s admin username and password, and Node.js 22+ (for stdio mode) or Docker.
D
Debmatic MCP Server
@claymore666
Basic information
About Debmatic MCP Server
# debmatic-mcp
Debmatic MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"debmatic": {
"command": "npx",
"args": [
"debmatic-mcp",
"--stdio"
],
"env": {
"CCU_HOST": "your-ccu-hostname-or-ip",
"CCU_PASSWORD": "your-ccu-admin-password"
}
}
}
}Debmatic MCP Server tools
18List all devices with their channels, types, and addresses. Optional filters: room, function, type, name. Use this first to discover device addresses for get_value/set_value.
List available communication interfaces (BidCos-RF, HmIP-RF, VirtualDevices, etc.).
List all rooms with their assigned channel IDs. Use with list_devices to find devices by room.
List all function groups (Heating, Lighting, etc.) with their assigned channel IDs.
List all automation programs. Use execute_program to trigger them.
List all system variables with current values and metadata. Use set_system_variable to modify them.
Get the full channel/datapoint schema for a device type (e.g. 'HmIP-eTRV-2'). Shows all channels, paramsets, datapoint names, types, ranges, and operations. Served from cache (instant). Use list_devices first to find device types.
Read a single datapoint value from a device channel. Only address and valueKey are required — interface is auto-resolved. Use list_devices to find addresses, describe_device_type to find valid valueKeys.
Read datapoint values for multiple channels at once via HM Script. Provide either a list of channel addresses, or filter by room or function name.
Read all parameters for a channel (VALUES, MASTER, or LINK). Interface is auto-resolved from the address.
Set a single datapoint value on a device channel. Only address, valueKey, and value are required — interface and type are auto-resolved. Returns the previous value for undo. Use describe_device_type to find valid valueKeys and ranges.
Write multiple parameters at once (e.g. thermostat weekly profile). Interface is auto-resolved from address.
Set a system variable value. Type is auto-detected — use list_system_variables to see available variables.
Trigger an automation program on the CCU. NOT idempotent — will not be auto-retried. Use list_programs to find program IDs.
Get all active service messages (low battery, unreachable, etc.) with device details and timestamps.
Get CCU system information: firmware version, serial number, addresses.
Context-aware help. No args: conceptual guide. Tool name (e.g. 'set_value'): tool usage. Device type (e.g. 'HmIP-eTRV-2'): capabilities from cache.
Execute arbitrary HomeMatic Script on the CCU. NOT idempotent — will not be auto-retried. Use for anything the other tools don't cover.
Overview
What is Debmatic Mcp?
Debmatic Mcp connects to any HomeMatic CCU (debmatic, CCU3, or OpenCCU) via its built-in JSON-RPC API and exposes devices, rooms, programs, and system variables as MCP tools. It works directly on your local network — no addons, no XML-API, no cloud required.
How to use Debmatic Mcp?
Install via npx ccu-mcp --stdio or run a Docker container with environment variables CCU_HOST and CCU_PASSWORD. Configure your MCP client (e.g., Claude Code) by adding a debmatic server entry in .mcp.json — either as a stdio subprocess or an HTTP server. The HTTP mode uses a bearer token generated on first startup.
Key features of Debmatic Mcp
- Connects directly to any HomeMatic CCU via its JSON-RPC API
- Exposes devices, rooms, programs, and system variables as MCP tools
- Supports stdio (subprocess) and HTTP (standalone) transports
- Bearer token authentication with rotation, TTL, and grace period
- TLS support with cert pinning, CA trust, or system verification
- CORS and DNS-rebinding protection for secure HTTP access
Use cases of Debmatic Mcp
- Ask an AI assistant for room temperatures, open windows, or low‑battery devices
- Set heating to a specific temperature or rename devices with consistent naming
- Find which room a window sensor belongs to or list devices with stale data
- Read gas meter readings or detect naming inconsistencies across channels
Frequently asked questions
How do I get the auth token for HTTP mode?
Run `docker exec ccu-mcp grep MCP_AUTH_TOKEN /data/.env` — the token is the part after `=`. The server generates it on first startup and saves it to the container’s data volume.
Does it work with HTTPS? How do I handle self‑signed certificates?
Yes. Set `CCU_HTTPS=true` and optionally `CCU_PORT=443`. The server accepts self‑signed certificates by default — you can pin the certificate fingerprint via `CCU_TLS_FINGERPRINT`, trust a CA file via `CCU_CA_CERT`, or enable system trust with `CCU_TLS_VERIFY=true`.
How can I protect against brute‑force attacks?
Use fail2ban. The server logs every rejected request as a structured JSON line to stderr, making it easy to parse. Ready‑to‑use fail2ban filter and jail configuration are provided in the `fail2ban/` directory.
What transport options are available?
Stdio (the server runs as a subprocess of the MCP client) and HTTP (a standalone Docker container that clients connect to over the network). Both are fully supported.
More Other MCP servers
Health by Dr Brad
Dr Brad StanfieldHealth by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
23.2K
Yuppsy
Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code
The Living Bread
The Living BreadA free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w
EverArt
modelcontextprotocolModel Context Protocol Servers
88.1K
Comments