PluginBench
MCP Server
Active
MIT

io.github.claymore666/ccu-mcp MCP Server

io.github.claymore666/ccu-mcp

RepositoryRegistry

What is the io.github.claymore666/ccu-mcp MCP server?

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

How to install io.github.claymore666/ccu-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • CCU_HOST
    required

    Hostname or IP of your HomeMatic CCU (debmatic, CCU3, or OpenCCU/RaspberryMatic)

  • CCU_PASSWORD
    required
    secret

    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

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ccu-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ccu-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "<YOUR_CCU_HOST>",
        "CCU_PASSWORD": "<YOUR_CCU_PASSWORD>",
        "CCU_USER": "<YOUR_CCU_USER>",
        "CCU_HTTPS": "<YOUR_CCU_HTTPS>",
        "CCU_PORT": "<YOUR_CCU_PORT>",
        "CACHE_DIR": "<YOUR_CACHE_DIR>",
        "MCP_ALLOWED_ORIGINS": "<YOUR_MCP_ALLOWED_ORIGINS>",
        "MCP_ALLOWED_HOSTS": "<YOUR_MCP_ALLOWED_HOSTS>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "ccu-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ccu-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "<YOUR_CCU_HOST>",
        "CCU_PASSWORD": "<YOUR_CCU_PASSWORD>",
        "CCU_USER": "<YOUR_CCU_USER>",
        "CCU_HTTPS": "<YOUR_CCU_HTTPS>",
        "CCU_PORT": "<YOUR_CCU_PORT>",
        "CACHE_DIR": "<YOUR_CACHE_DIR>",
        "MCP_ALLOWED_ORIGINS": "<YOUR_MCP_ALLOWED_ORIGINS>",
        "MCP_ALLOWED_HOSTS": "<YOUR_MCP_ALLOWED_HOSTS>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ccu-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ccu-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "<YOUR_CCU_HOST>",
        "CCU_PASSWORD": "<YOUR_CCU_PASSWORD>",
        "CCU_USER": "<YOUR_CCU_USER>",
        "CCU_HTTPS": "<YOUR_CCU_HTTPS>",
        "CCU_PORT": "<YOUR_CCU_PORT>",
        "CACHE_DIR": "<YOUR_CACHE_DIR>",
        "MCP_ALLOWED_ORIGINS": "<YOUR_MCP_ALLOWED_ORIGINS>",
        "MCP_ALLOWED_HOSTS": "<YOUR_MCP_ALLOWED_HOSTS>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "ccu-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ccu-mcp",
        "--stdio"
      ],
      "env": {
        "CCU_HOST": "<YOUR_CCU_HOST>",
        "CCU_PASSWORD": "<YOUR_CCU_PASSWORD>",
        "CCU_USER": "<YOUR_CCU_USER>",
        "CCU_HTTPS": "<YOUR_CCU_HTTPS>",
        "CCU_PORT": "<YOUR_CCU_PORT>",
        "CACHE_DIR": "<YOUR_CACHE_DIR>",
        "MCP_ALLOWED_ORIGINS": "<YOUR_MCP_ALLOWED_ORIGINS>",
        "MCP_ALLOWED_HOSTS": "<YOUR_MCP_ALLOWED_HOSTS>"
      }
    }
  }
}
Claude Code
claude mcp add ccu-mcp --env CCU_HOST=<YOUR_CCU_HOST> --env CCU_PASSWORD=<YOUR_CCU_PASSWORD> --env CCU_USER=<YOUR_CCU_USER> --env CCU_HTTPS=<YOUR_CCU_HTTPS> --env CCU_PORT=<YOUR_CCU_PORT> --env CACHE_DIR=<YOUR_CACHE_DIR> --env MCP_ALLOWED_ORIGINS=<YOUR_MCP_ALLOWED_ORIGINS> --env MCP_ALLOWED_HOSTS=<YOUR_MCP_ALLOWED_HOSTS> -- npx -y ccu-mcp --stdio

Related MCP servers

io.github.claymore666/debmatic-mcp

Active

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

2
TypeScript
MIT
View repository →
io.github.claymore666/ccu-mcp MCP Server | PluginBench