Skip to content
mcp/harbor
Cursor

ccu mcp for Cursor

io.github.claymore666/ccu-mcp

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

client:Cursor transport:stdio runtime:npm

Install ccu mcp in Cursor

~/.cursor/mcp.json · windows: %USERPROFILE%\.cursor\mcp.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen. 

{
  "mcpServers": {
    "ccu-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ccu-mcp"
      ],
      "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>",
        "CCU_PROFILES": "<CCU_PROFILES>",
        "CCU_DEFAULT_PROFILE": "<CCU_DEFAULT_PROFILE>",
        "CCU_TLS_VERIFY": "<CCU_TLS_VERIFY>",
        "CCU_TLS_FINGERPRINT": "<CCU_TLS_FINGERPRINT>",
        "CCU_CA_CERT": "<CCU_CA_CERT>",
        "CCU_TIMEOUT": "<CCU_TIMEOUT>",
        "CCU_SCRIPT_TIMEOUT": "<CCU_SCRIPT_TIMEOUT>",
        "CACHE_TTL": "<CACHE_TTL>",
        "CCU_RATE_LIMIT_BURST": "<CCU_RATE_LIMIT_BURST>",
        "CCU_RATE_LIMIT_RATE": "<CCU_RATE_LIMIT_RATE>",
        "RESOURCE_POLL_INTERVAL": "<RESOURCE_POLL_INTERVAL>",
        "LOG_LEVEL": "<LOG_LEVEL>"
      }
    }
  }
}

Use .cursor/mcp.json in a project root instead to scope it to that project. Cursor merges both. Cursor docs

ccu mcp in other clients

ccu mcp MCP server