Controls a HomeMatic/debmatic CCU via JSON-RPC: switch and dim actuators, read sensors and variables, run programs and manage rooms.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add debmatic --env CCU_HOST='<CCU_HOST>' --env CCU_PASSWORD='<CCU_PASSWORD>' -- npx -y ccu-mcp~/.codex/config.toml
[mcp_servers.debmatic]
command = "npx"
args = ["-y", "ccu-mcp"]
env = { CCU_HOST = "<CCU_HOST>", CCU_PASSWORD = "<CCU_PASSWORD>" }
# codex mcp add debmatic --env CCU_HOST='<CCU_HOST>' --env CCU_PASSWORD='<CCU_PASSWORD>' -- npx -y ccu-mcp~/.cursor/mcp.json
{
"mcpServers": {
"debmatic": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"debmatic": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"debmatic": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"debmatic": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"debmatic": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<CCU_HOST>",
"CCU_PASSWORD": "<CCU_PASSWORD>"
}
}
}
}Environment variables
CCU_HOSTCCU_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.