Debmatic MCP Server

by claymore666io.github.claymore666/debmatic-mcpv1.3.0

Control a HomeMatic/debmatic CCU: switch and dim actuators, read sensors and system variables, run programs and manage rooms, links and devices.

9Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Debmatic MCP server

claude mcp add debmatic -e CCU_HOST='<ccu-host>' -e CCU_PASSWORD='<ccu-password>' -- npx -y debmatic-mcp --stdio

{
  "mcpServers": {
    "debmatic": {
      "command": "npx",
      "args": [
        "-y",
        "debmatic-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "<ccu-host>",
        "CCU_PASSWORD": "<ccu-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "debmatic": {
      "command": "npx",
      "args": [
        "-y",
        "debmatic-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "<ccu-host>",
        "CCU_PASSWORD": "<ccu-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "debmatic": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "debmatic-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "<ccu-host>",
        "CCU_PASSWORD": "<ccu-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "debmatic": {
      "command": "npx",
      "args": [
        "-y",
        "debmatic-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "<ccu-host>",
        "CCU_PASSWORD": "<ccu-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CCU_HOST	yes	—	Hostname or IP of your HomeMatic CCU (debmatic, CCU3, or RaspberryMatic)
CCU_PASSWORD	yes	yes	CCU admin password (same as the WebUI login)
CCU_USER	—	—	CCU username
CCU_HTTPS	—	—	Connect to the CCU via HTTPS (self-signed certificates supported)
CCU_PORT	—	—	CCU API port (80 for HTTP, 443 for HTTPS)
CACHE_DIR	—	—	Directory for the device type cache and session persistence
MCP_ALLOWED_ORIGINS	—	—	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_HOSTS	—	—	Extra Host header values accepted by DNS-rebinding protection (comma-separated host:port); add your hostname when behind a proxy or container DNS name

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 3d ago · GitHub
Latest release
2026-10-07 · 3d ago · GitHub · v1.11.4
Package published
no data · npm/PyPI
Registry entry updated
2026-06-17 · 4mo ago · official registry · v1.3.0

FAQ

›How do I install the Debmatic MCP server in Claude Code?

Run: claude mcp add debmatic -e CCU_HOST='<ccu-host>' -e CCU_PASSWORD='<ccu-password>' -- npx -y debmatic-mcp --stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Debmatic require an API key?

Yes. It expects CCU_HOST, CCU_PASSWORD, of which 1 is a secret.

›Can I use Debmatic as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Debmatic in the official MCP registry?

Yes, as io.github.claymore666/debmatic-mcp.