MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API
Connect Runs on your machine
claude mcp add debmatic-mcp -e CCU_HOST=<CCU_HOST> -e CCU_PASSWORD=<CCU_PASSWORD> -e CCU_USER=<CCU_USER> -e CCU_HTTPS=<CCU_HTTPS> -e CCU_PORT=<CCU_PORT> -e CACHE_DIR=<CACHE_DIR> -e MCP_ALLOWED_ORIGINS=<MCP_ALLOWED_ORIGINS> -e MCP_ALLOWED_HOSTS=<MCP_ALLOWED_HOSTS> -- npx -y [email protected]{
"mcpServers": {
"debmatic-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>",
"CCU_USER": "<CCU_USER>",
"CCU_HTTPS": "<CCU_HTTPS>",
"CCU_PORT": "<CCU_PORT>",
"CACHE_DIR": "<CACHE_DIR>",
"MCP_ALLOWED_ORIGINS": "<MCP_ALLOWED_ORIGINS>",
"MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
}
}
}
}{
"mcpServers": {
"debmatic-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>",
"CCU_USER": "<CCU_USER>",
"CCU_HTTPS": "<CCU_HTTPS>",
"CCU_PORT": "<CCU_PORT>",
"CACHE_DIR": "<CACHE_DIR>",
"MCP_ALLOWED_ORIGINS": "<MCP_ALLOWED_ORIGINS>",
"MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
}
}
}
}{
"servers": {
"debmatic-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>",
"CCU_USER": "<CCU_USER>",
"CCU_HTTPS": "<CCU_HTTPS>",
"CCU_PORT": "<CCU_PORT>",
"CACHE_DIR": "<CACHE_DIR>",
"MCP_ALLOWED_ORIGINS": "<MCP_ALLOWED_ORIGINS>",
"MCP_ALLOWED_HOSTS": "<MCP_ALLOWED_HOSTS>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
CCU_HOSTRequired | Hostname or IP of your HomeMatic CCU (debmatic, CCU3, or RaspberryMatic) |
CCU_PASSWORDRequired, secret | CCU admin password (same as the WebUI login) |
CCU_USEROptional | CCU username |
CCU_HTTPSOptional | Connect to the CCU via HTTPS (self-signed certificates supported) |
CCU_PORTOptional | CCU API port (80 for HTTP, 443 for HTTPS) |
CACHE_DIROptional | Directory for the device type cache and session persistence |
MCP_ALLOWED_ORIGINSOptional | Comma-separated allowlist of browser origins. Unset = no cross-origin browser access (default-deny). An allowlisted origin is reflected exactly in Access-Control-Allow-Origin (never '*'); the list also drives DNS-rebinding origin checks |
MCP_ALLOWED_HOSTSOptional | Extra Host header values accepted by DNS-rebinding protection (comma-separated host:port); add your hostname when behind a proxy or container DNS name |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 17 Jun 2026 |
| Last updated | 17 Jun 2026 |
| Registry name | io.github.claymore666/debmatic-mcp |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.