MCP server for controlling HomeMatic smart home devices via the CCU JSON-RPC API
registry version 1.11.8
npm
npx -y ccu-mcpnpm
npx -y ccu-mcp@1.11.8
Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.
claude_desktop_config.json
{
"mcpServers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<YOUR_CCU_HOST>",
"CCU_PASSWORD": "<YOUR_CCU_PASSWORD>"
}
}
}
}{
"mcpServers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp@1.11.8"
],
"env": {
"CCU_HOST": "<YOUR_CCU_HOST>",
"CCU_PASSWORD": "<YOUR_CCU_PASSWORD>"
}
}
}
}Format verified against the official Claude Desktop docs ↗.
terminal
claude mcp add --env CCU_HOST=<YOUR_CCU_HOST> --env CCU_PASSWORD=<YOUR_CCU_PASSWORD> ccu-mcp -- npx -y ccu-mcp
claude mcp add --env CCU_HOST=<YOUR_CCU_HOST> --env CCU_PASSWORD=<YOUR_CCU_PASSWORD> ccu-mcp -- npx -y ccu-mcp@1.11.8
Format verified against the official Claude Code docs ↗.
.cursor/mcp.json
{
"mcpServers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<YOUR_CCU_HOST>",
"CCU_PASSWORD": "<YOUR_CCU_PASSWORD>"
}
}
}
}{
"mcpServers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp@1.11.8"
],
"env": {
"CCU_HOST": "<YOUR_CCU_HOST>",
"CCU_PASSWORD": "<YOUR_CCU_PASSWORD>"
}
}
}
}Format verified against the official Cursor docs ↗.
.vscode/mcp.json
{
"servers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<YOUR_CCU_HOST>",
"CCU_PASSWORD": "<YOUR_CCU_PASSWORD>"
}
}
}
}{
"servers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp@1.11.8"
],
"env": {
"CCU_HOST": "<YOUR_CCU_HOST>",
"CCU_PASSWORD": "<YOUR_CCU_PASSWORD>"
}
}
}
}Format verified against the official VS Code docs ↗.
mcp_config.json
{
"mcpServers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp"
],
"env": {
"CCU_HOST": "<YOUR_CCU_HOST>",
"CCU_PASSWORD": "<YOUR_CCU_PASSWORD>"
}
}
}
}{
"mcpServers": {
"ccu-mcp": {
"command": "npx",
"args": [
"-y",
"ccu-mcp@1.11.8"
],
"env": {
"CCU_HOST": "<YOUR_CCU_HOST>",
"CCU_PASSWORD": "<YOUR_CCU_PASSWORD>"
}
}
}
}Format verified against the official Windsurf docs ↗.
Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.
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). Must be set; the value may be empty for a CCU with no passwordCCU_USER — CCU usernameCCU_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 persistenceMCP_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-rebindiMCP_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⭐ 9 stars · 最近更新于 44 天前 · MIT license
Distributed as npm, listed under Developer Tools. Review our MCP security guide before granting access to real data.
Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.
The MCP server itself is free to install. The source is public on https://github.com/claymore666/ccu-mcp. Any third-party service it calls may require its own API key and account.
Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.
Publish this server? Link back with a badge on your README or site — copy either snippet.
Markdown
[](https://mcpnav.net/server/ccu-mcp/)
HTML
<a href="https://mcpnav.net/server/ccu-mcp/"><img src="https://mcpnav.net/badge/ccu-mcp.svg" alt="Listed on MCPNav" height="20"></a>