Debmatic MCP Server

MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API

Local serverstdio

What is the Debmatic MCP Server?

MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API

What it actually does

Talk to your HomeMatic smart home from Claude, Cursor, or any MCP client.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Debmatic MCP Server

{
  "mcpServers": {
    "debmatic": {
      "command": "npx",
      "args": ["-y", "ccu-mcp"],
      "env": {
        "CCU_HOST": "your-value",
        "CCU_PASSWORD": "your-value",
        "MCP_AUTH_TOKEN": "your-value",
        "MCP_TLS_KEY": "your-value",
        "CCU_PROD_HOST": "your-value",
        "CCU_DEV_HOST": "your-value",
        "CCU__HOST": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • A running HomeMatic CCU (debmatic, CCU3, or OpenCCU — formerly RaspberryMatic) reachable on your network - The CCU's admin username and password (the same credentials you use to log into the WebUI) - Node.js 24+ (for running from source or stdio mode) or Docker
VariableDescriptionRequired
CCU_HOSTEndpoint or connection string the server talks to.Optional
CCU_PASSWORDConfiguration value read at startup.Optional
MCP_AUTH_TOKENCredential the server authenticates with.Yes
MCP_TLS_KEYCredential the server authenticates with.Yes
CCU_PROD_HOSTEndpoint or connection string the server talks to.Optional
CCU_DEV_HOSTEndpoint or connection string the server talks to.Optional

Frequently asked questions

MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.