Debmatic FAQs

Question 1

Which HomeMatic systems are compatible with Debmatic?

Accepted Answer

Debmatic is built for 'debmatic' (HomeMatic on Debian), but it is fully compatible with any HomeMatic CCU3 or RaspberryMatic installation that exposes the standard `/api/homematic.cgi` endpoint on your local network. It supports both wired and wireless (BidCos-RF, HmIP-RF) devices.

Question 2

What is Debmatic and how does it connect to HomeMatic?

Accepted Answer

Debmatic is a tool that integrates your HomeMatic smart home system with Model Context Protocol (MCP) clients, such as AI assistants like Claude or Cursor. It connects directly to your HomeMatic CCU's built-in JSON-RPC API over your local network, bypassing the need for cloud services or additional XML-API addons.

Question 3

What are the deployment options for Debmatic?

Accepted Answer

Debmatic offers flexible deployment: 'stdio' mode (simplest) runs as a direct subprocess of your MCP client, requiring Node.js. Alternatively, for standalone operation or multiple clients, you can deploy it as an HTTP server in a Docker container, accessible over your network.

Question 4

What can I do with Debmatic and an AI assistant?

Accepted Answer

Debmatic exposes your HomeMatic devices, rooms, programs, and system variables as MCP tools, allowing AI assistants to interact with your smart home. You can ask for sensor readings (e.g., temperature, battery levels), control devices (e.g., set heating, open windows), execute programs, and even perform complex queries or renaming operations.

Question 5

Does Debmatic support secure connections and local caching?

Accepted Answer

Yes, Debmatic supports connecting to your CCU via HTTPS, including self-signed certificates. It also logs in and caches the session for reuse, and locally stores device type schemas, reducing CCU load and enabling the AI to quickly understand device capabilities without repeated requests.

Debmatic

Debmatic

主な機能

ユースケース

主な機能

ユースケース