The MyStiebel integration allows you to connect and control your Stiebel Eltron heat pump boiler through the official MyStiebel cloud service. It provides a comprehensive set of entities to monitor and manage your device directly from Home Assistant.
This integration was built by reverse-engineering the API used by the official MyStiebel mobile app and is not officially affiliated with Stiebel Eltron.
Note: This integration has been tested with a WWK-I 200 Plus heat pump boiler. While it is designed to support other Stiebel Eltron devices, adding support for additional models may require extra development and testing. As I do not have access to other devices, contributions and feedback from users with different models are highly appreciated.
This integration provides a rich set of features to fully integrate your Stiebel Eltron device into Home Assistant:
- Multi-Device Support: The configuration flow allows you to add multiple Stiebel Eltron devices from a single MyStiebel account, each appearing as a separate device in Home Assistant.
- Rich Device Information: Automatically populates device information, including model, manufacturer, software version, and MAC address.
- Full Control Suite: Provides entities for complete control over your device's settings:
- Switches: For toggling functions like the hygiene program, frost protection, and more.
- Numbers: For setting precise values like target temperatures and percentages.
- Selects: For choosing from a list of modes, such as the heating mode for Eco or Comfort settings.
- Advanced Sensors: In addition to standard sensors, the integration creates several combined and calculated sensors for a better user experience:
- Human-readable error messages instead of cryptic codes.
- Combined software version and Product ID (PID) sensors.
- Formatted runtime sensors for compressor and heating element (e.g., "8 d, 20 h").
- Calculated sensors for "Available Baths" and "Available Shower Time" based on user-configurable values.
- Smart Entity Management: To provide a clean user experience out-of-the-box, only a curated list of essential sensors and controls are enabled by default. All other "installer" or diagnostic entities are created but disabled, and can be enabled by the user via the entity registry.
- Multilingual Support: All entity names and configuration screens are fully translated and will automatically use the language configured in your Home Assistant instance (supports English, Dutch, German, Polish, Slovenian, Italian, French, Spanish, Czech, Hungarian, and Slovak based on the provided data).
- A Stiebel Eltron account registered with the MyStiebel service.
- Home Assistant Community Store (HACS) installed to easily manage this custom integration.
The recommended way to install this integration is through the Home Assistant Community Store (HACS).
-
Add Custom Repository in HACS:
- Go to HACS > Integrations in your Home Assistant sidebar.
- Click the three dots in the top right corner and select "Custom repositories".
- In the "Repository" field, paste the URL of your GitHub repository.
- In the "Category" dropdown, select "Integration".
- Click "ADD".
-
Install the Integration:
- The "MyStiebel" integration will now appear in your HACS integrations list.
- Click on it and then click the "DOWNLOAD" button.
- Follow the prompts to complete the download.
-
Restart Home Assistant:
- After installation, you must restart Home Assistant for the integration to be loaded. Go to Settings > System and click the "RESTART" button.
Configuration is done entirely through the Home Assistant UI.
- Navigate to Settings > Devices & Services.
- Click the "+ ADD INTEGRATION" button in the bottom right.
- Search for "MyStiebel" and click on it.
- Step 1: Credentials: You will be asked to enter your MyStiebel username and password.
- Step 2: Device Selection: The integration will connect to your account and discover your device(s). Select the specific device you want to add from the dropdown menu.
- Click "SUBMIT".
The integration will be set up, and a new device with all its entities will be added to Home Assistant. You can repeat this process to add other devices from your account.
By default, only a small set of essential entities are enabled to keep your dashboard clean. To enable more "installer" or diagnostic entities:
- Navigate to the device page for your Stiebel Eltron device.
- Click on the link that says
XX entities. - You will see a list of all entities, with many marked as "disabled".
- Click on any disabled entity you want to use, and use the toggle in the top right of the dialog box to enable it.
You can configure the values for the calculated sensors (Available Baths and Shower Time).
- Navigate to Settings > Devices & Services.
- Find the MyStiebel integration and click the "CONFIGURE" button.
- Set your average volume for a bath and output for a shower. The integration will automatically reload with the new values.
The integration creates 42 time entities to control the heating schedules.
Contributions are welcome! If you find a bug or have a feature request, please open an issue on the GitHub repository.
This is a third-party integration and is not officially supported by Stiebel Eltron. Use at your own risk.