Monitor and control your Bosch/Siemens/Neff/Balay appliances from Domoticz via the Home Connect cloud API.

Supported brands: Bosch · Siemens · Neff · Balay

Before you begin, make sure you have the following:

• Domoticz 2022.1 or later with Python plugin support enabled
• Python 3.6+ installed on the Domoticz host
• requests library — install with:

  pip install requests

• A Home Connect account at home-connect.com
• At least one supported appliance added to the Home Connect app on your phone
• Network access to api.home-connect.com — this is a cloud-based API; there is no local/LAN alternative

1. Clone the repository into your Domoticz plugins directory:

   cd /home/pi/domoticz/plugins
   git clone https://github.com/domoticz/home-connect.git HomeConnect

   On Windows, open a terminal in C:\domoticz\plugins\ and run:

   git clone https://github.com/domoticz/home-connect.git HomeConnect
   

2. Install the required Python library:

   pip install -r /home/pi/domoticz/plugins/HomeConnect/requirements.txt

   Docker users: The official Domoticz Docker image already includes all necessary Python libraries. You can skip this step.

3. Restart Domoticz to detect the new plugin:

   sudo systemctl restart domoticz

Important: Home Connect does not accept internal (LAN) IP addresses such as 192.168.x.x or 127.0.0.1 as redirect URIs. The redirect URI you register must be reachable from the internet.

You have two options:

Option A — Use your external IP address

Find your router's external (public) IP address (e.g. from whatismyip.com). Then set up port forwarding on your router:

• External port: 9500 (or whichever port you choose)
• Internal destination: your Domoticz server's LAN IP and the same port (e.g. 192.168.0.70:9500)

Your redirect URI will be: http://<your-external-ip>:9500/callback

Option B — Use a dynamic DNS hostname (recommended)

If your external IP address changes regularly (most home connections), use a free dynamic DNS service such as DuckDNS or No-IP to get a stable hostname (e.g. myhome.duckdns.org). Set up port forwarding as in Option A.

Your redirect URI will be: http://myhome.duckdns.org:9500/callback

Note: The redirect URI only needs to be reachable at the moment you perform the one-time authorization in Step 5. After that, the plugin uses the saved tokens and never uses the redirect URI again. Port forwarding can be removed afterwards if desired.

The port (9500 by default) can be changed. If you change it, update both the Domoticz hardware settings and the redirect URI in the developer portal.

You need to register an OAuth application in the Home Connect developer portal to obtain API credentials.

1. Go to developer.home-connect.com and sign in with your Home Connect account (the same account your appliances are registered to).

2. Navigate to Applications → Register Application.

3. Fill in the registration form:

   • Application ID Any name you like, e.g. Domoticz.

   • OAuth Flow Select Authorization Code Grant.

   • Home Connect User Account Enable "Use same credentials as developer account". This links the developer app to your real appliances.

   • Redirect URI Enter the externally reachable URI you determined in Step 2, for example:

     http://myhome.duckdns.org:9500/callback
     

     or with an external IP:

     http://1.2.3.4:9500/callback
     

     This must exactly match what you configure in Domoticz (same host, same port, same path /callback). Internal IP addresses (192.168.x.x, 127.0.0.1) will not work — Home Connect rejects them with a 403 error.

4. Click Save.

5. On the application details page, copy your Client ID and Client Secret. Keep the Client Secret private — treat it like a password.

1. In Domoticz, go to Settings → Hardware.

2. Click Add and fill in the following fields:

   • Name Any descriptive name, e.g. Home Connect.

   • Type Select Bosch Home Connect from the dropdown.

   • Client ID Paste the Client ID from Step 3.

   • Client Secret Paste the Client Secret from Step 3.

   • OAuth Callback Host Enter the externally reachable hostname or IP address you determined in Step 2. This must exactly match the host part of the redirect URI you registered in Step 3. Internal IP addresses such as 192.168.x.x will not work — use your external IP or dynamic DNS hostname. Examples: 1.2.3.4, myhome.duckdns.org.

   • OAuth Callback Port The port the plugin listens on for the OAuth callback. Default: 9500. Must match the port in the redirect URI registered in Step 3.

   • Debug Leave as Off for normal use. See Debug Modes for options.

3. Click Save.

The plugin will start and log an authorization URL to the Domoticz log within a few seconds.

Authorization only needs to be done once. The plugin saves the tokens and refreshes them automatically afterwards.

1. Open the Domoticz log: Setup → Log.

2. Find the line logged by the plugin that starts with:

   HomeConnect: Please authorize at: https://api.home-connect.com/security/oauth/authorize?...
   

3. Copy the full URL and open it in a web browser. Use a browser that can reach the OAuth Callback Host you configured — typically a browser on the same network as Domoticz.

4. Log in to your Home Connect account and click Allow to grant the requested permissions.

5. Your browser will be redirected to http://<your-host>:<port>/callback?code=.... The plugin's built-in HTTP server receives this redirect, exchanges the authorization code for tokens, and saves them to disk. You will see a simple confirmation page — you can close the browser tab.

6. The Domoticz log will show:

   HomeConnect: Authorization successful.
   

7. Devices for all discovered appliances will appear in Domoticz under Switches and Sensors within a few seconds.

Token storage: Tokens are saved to plugins/HomeConnect/tokens.json. Keep this file private — it grants access to your Home Connect account. Do not include it in version control.

Each appliance creates a group of Domoticz devices named <Appliance Name> - <Device>. For example, a washer named "Washing Machine" creates devices like: Washing Machine - Power, Washing Machine - Program, Washing Machine - Progress, etc.

1. Run the plugin with mode 3 while your appliances are active to capture a set of real API responses.
2. Switch to mode 4 to replay those saved responses without making any network calls.
3. Return to mode 0 for normal production use.

Cache files are stored as http_cache/GET_api_homeappliances.json etc., named after the HTTP method and URL path. They can be committed to version control as test fixtures or shared with developers.

• Cloud-only: The Home Connect API requires an active internet connection. Bosch/Siemens do not provide a local LAN API.
• API rate limits: The developer sandbox allows approximately 250 calls/day. Production apps have higher limits. The plugin minimizes calls by using SSE streaming for real-time updates rather than polling.
• Remote start: Programs can only be started remotely when the appliance has Remote Control enabled. Enable this in the appliance's own settings menu or in the Home Connect app.
• Real-time updates: A background thread maintains a persistent SSE connection to the API. State changes are typically reflected in Domoticz within 1–2 seconds.
• Multiple accounts: Each Domoticz hardware instance supports one Home Connect account. To monitor appliances from multiple accounts, add multiple hardware instances with separate credentials.

MIT License — see LICENSE for details.