MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API
Use this profile to copy client config, check auth requirements, review tools and resources, and compare related MCP servers before adding it to an AI client.
Get practical integration notes and launch examples for MCP servers like ccu-mcp.
npx -y ccu-mcp{
"CCU_HOST": "YOUR_VALUE_HERE",
"CCU_PASSWORD": "YOUR_SECRET_VALUE",
"CCU_USER": "Admin",
"CCU_HTTPS": "false",
"CCU_PORT": "80",
"CACHE_DIR": "/data",
"MCP_ALLOWED_ORIGINS": "YOUR_VALUE_HERE",
"MCP_ALLOWED_HOSTS": "YOUR_VALUE_HERE",
"CCU_PROFILES": "YOUR_VALUE_HERE",
"CCU_DEFAULT_PROFILE": "YOUR_VALUE_HERE",
"CCU_TLS_VERIFY": "false",
"CCU_TLS_FINGERPRINT": "YOUR_VALUE_HERE",
"CCU_CA_CERT": "YOUR_VALUE_HERE",
"CCU_TIMEOUT": "10000",
"CCU_SCRIPT_TIMEOUT": "30000",
"CACHE_TTL": "86400",
"CCU_RATE_LIMIT_BURST": "20",
"CCU_RATE_LIMIT_RATE": "10",
"RESOURCE_POLL_INTERVAL": "60",
"LOG_LEVEL": "info"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-claymore666-ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "YOUR_VALUE_HERE",
"CCU_PASSWORD": "YOUR_SECRET_VALUE",
"CCU_USER": "Admin",
"CCU_HTTPS": "false",
"CCU_PORT": "80",
"CACHE_DIR": "/data",
"MCP_ALLOWED_ORIGINS": "YOUR_VALUE_HERE",
"MCP_ALLOWED_HOSTS": "YOUR_VALUE_HERE",
"CCU_PROFILES": "YOUR_VALUE_HERE",
"CCU_DEFAULT_PROFILE": "YOUR_VALUE_HERE",
"CCU_TLS_VERIFY": "false",
"CCU_TLS_FINGERPRINT": "YOUR_VALUE_HERE",
"CCU_CA_CERT": "YOUR_VALUE_HERE",
"CCU_TIMEOUT": "10000",
"CCU_SCRIPT_TIMEOUT": "30000",
"CACHE_TTL": "86400",
"CCU_RATE_LIMIT_BURST": "20",
"CCU_RATE_LIMIT_RATE": "10",
"RESOURCE_POLL_INTERVAL": "60",
"LOG_LEVEL": "info"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
ccu-mcp is an MCP server for MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API. It supports STDIO transport.
Use the generated config in Install. This server runs with npx -y ccu-mcp; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for npx -y ccu-mcp. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for npx -y ccu-mcp. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for npx -y ccu-mcp. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for npx -y ccu-mcp. Add required environment variables before starting Cursor or VS Code.
ccu-mcp uses STDIO transport. Use the package or command config in Install.
ccu-mcp inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
ccu-mcp is marked with Auth required by registry metadata auth. You may need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
ccu-mcpstdio | npm | 1.9.1 | Env: CCU_HOST required Env: CCU_PASSWORD required secret Env: CCU_USER Env: CCU_HTTPS Env: CCU_PORT Env: CACHE_DIR Env: MCP_ALLOWED_ORIGINS Env: MCP_ALLOWED_HOSTS Env: CCU_PROFILES Env: CCU_DEFAULT_PROFILE Env: CCU_TLS_VERIFY Env: CCU_TLS_FINGERPRINT Env: CCU_CA_CERT Env: CCU_TIMEOUT Env: CCU_SCRIPT_TIMEOUT Env: CACHE_TTL Env: CCU_RATE_LIMIT_BURST Env: CCU_RATE_LIMIT_RATE Env: RESOURCE_POLL_INTERVAL Env: LOG_LEVEL |