# debmatic-mcp
Connects to a **HomeMatic CCU**'s built-in JSON-RPC API and exposes your devices, rooms, programs, and system
variables as MCP tools — **no addons, no XML-API, no cloud**, just a direct connection on your local network.
Works with **debmatic**, **CCU3**, and **RaspberryMatic**.
## Features
- **25 tools** spanning device control, diagnostics, and configuration
- **Read**: list devices/rooms/functions/programs/system variables, read values & paramsets, describe device
types, list links
- **Control**: set values, run programs, set/create/delete system variables, assign/unassign channels, execute
HM-Script
- **Diagnostics**: RSSI/radio quality, service messages (read + acknowledge), system info
- **Production-hardened**: bearer-token auth with expiry & rotation, optional native TLS, CCU certificate
verification (fingerprint pin or CA), rate limiting, DNS-rebinding protection, and structured tool output
(`outputSchema`)
## Install
```json
{
"mcpServers": {
"debmatic": {
"command": "npx",
"args": ["-y", "debmatic-mcp", "--stdio"],
"env": {
"CCU_HOST": "your-ccu-host",
"CCU_PASSWORD": "your-ccu-password"
}
}
}
}
Configuration
Required: CCU_HOST, CCU_PASSWORD
Common optional: CCU_USER (default Admin), CCU_HTTPS (default false), CCU_PORT (80/443), CACHE_DIR (default /data)
Also runs as a standalone HTTP server (Docker) for networked clients. Full docs in the README.
Repo: https://github.com/claymore666/debmatic-mcp · npm: debmatic-mcp · License: MIT