[Custom Integration] Bosch/Buderus Heating - PointT cloud integration for MyBuderus and HomeCom Easy systems

Share your Projects! Custom Integrations
1

Hi everyone,

I would like to introduce Bosch/Buderus Heating, an independent Home
Assistant integration for compatible Bosch and Buderus heat pumps and heating
systems connected through the PointT cloud.

It uses the same SingleKey ID account and cloud service as the MyBuderus
and HomeCom Easy apps.

This integration is intended for heating systems. It is not related to Bosch
Smart Home or Home Connect.

Repository:

What it provides

  • UI-based setup and reauthentication with SingleKey ID
  • Automatic discovery of supported PointT resources
  • Multiple gateways and dynamically discovered heating circuits, hot-water
    circuits, and heat sources
  • Temperatures, system pressure, operating states, starts, and operating hours
  • Current heat-source power, brine temperatures, compressor status,
    auxiliary-heater status, defrost state, emergency mode, and standby status
  • Active faults, warnings, and maintenance notifications
  • Events when notifications appear or are resolved
  • Electricity consumption, produced heat, cooling energy, and calculated
    environmental energy
  • Heating-circuit modes and temperature setpoints
  • Hot-water modes, temperature levels, and extra-hot-water controls
  • Away mode
  • Silent Mode and auxiliary-heater mode controls when supported
  • Guarded maximum-supply-temperature control, disabled by default
  • Holiday calendar with multiple periods and supported create, edit, move,
    rename, and delete operations
  • Optional monitoring for hybrid systems, power limiting, solar, pool,
    ventilation, room zones, room devices, photovoltaics, fresh-water stations,
    and gateway-provided tariff status
  • German and English entity names and state translations

The integration does not expose every raw cloud value automatically. Entities
are created only when the connected installation provides a known resource
with a compatible data type and unit.

Unsupported optional paths are discarded after the initial capability check
and are not polled continuously.

Safe controls

Before sending a change, the integration checks whether the resource is still
writable and whether the requested value is permitted by the heating system.

Every successful write is followed by a separate read-back. Writes are never
retried blindly. If PointT does not confirm the requested value, Home Assistant
reports the change as unsuccessful instead of assuming it worked.

The following controls have completed physical write and read-back tests on
the Buderus K40 reference installation:

  • Heating-circuit operating mode
  • Silent Mode
  • Auxiliary-heater mode
  • Maximum supply temperature

The maximum-supply-temperature control is considered an installer-level
setting and is therefore disabled by default.

Faults and notifications

When supported by the installation, the integration provides:

  • System fault — problem binary sensor
  • Active faults — number of active system problems
  • Active notifications — faults, warnings, and maintenance messages
  • System notifications — event entity for appeared and resolved
    transitions

Unknown manufacturer codes remain visible but are not assigned an invented
meaning.

Home Assistant does not replace the appliance display, the official
manufacturer documentation, or a qualified technician.

Holiday periods

Supported gateways receive:

  • Holiday mode active binary sensor
  • Next holiday timestamp sensor
  • Holiday periods calendar

Holiday periods can be created, moved, renamed, edited, and deleted through
Home Assistant. Their heating, hot-water, ventilation, circuit-assignment,
thermal-disinfection, and constant-temperature settings can be configured
separately when the gateway advertises those options.

Holiday mode remains separate from the normal Away mode switch.

A detailed holiday guide is available in the repository under
docs/holiday-periods.md.

Reliability and cloud usage

Resources with similar update intervals are grouped into batch requests.
Live values, settings, energy counters, long-term values, and static
information use separate polling intervals.

Temporary cloud failures retain the last confirmed values. Partial responses,
rate limits, unsupported resources, and individual device errors do not make
the complete installation unavailable.

Downloadable diagnostics contain capability schemas and request counters but
exclude credentials, raw measurements, stable device identifiers,
user-defined names, and unknown cloud payloads.

Compatibility

The integration has currently been tested with a Buderus heat-pump
installation using a K40 gateway.

It is designed for compatible Bosch and Buderus systems using:

  • MX300
  • MX400
  • K30 / K30RF
  • K40 / K40RF

Compatibility depends on the resources exposed by the individual account,
gateway, controller, firmware, and heating system. A listed gateway does not
guarantee that every entity or control will be available.

Feedback would be particularly helpful from users with:

  • Bosch-branded installations
  • MX300, MX400, K30, K30RF, or K40RF gateways
  • Multiple heating or hot-water circuits
  • Multiple heat sources
  • Hybrid, solar, pool, ventilation, room-zone, or photovoltaic resources
  • Different fault, warning, and maintenance messages
  • Different holiday configurations and time zones

Installation

The integration is awaiting inclusion in the default HACS catalog under pull
request #10040.

Until then, install it as a custom HACS repository:

  1. Open HACS.

  2. Open the three-dot menu and select Custom repositories.

  3. Add:

    https://github.com/SoftwareSchmied/ha-bosch-buderus-heating

  4. Select Integration as the category.

  5. Install Bosch/Buderus Heating.

  6. Restart Home Assistant.

  7. Open Settings → Devices & services → Add integration.

  8. Search for Bosch/Buderus Heating.

The SingleKey ID authorization returns an app address rather than a normal web
page. The illustrated setup guide explains how to copy the complete return
address safely:

Home Assistant never asks for the SingleKey ID password.

Important notes

  • This is a cloud integration and requires internet access to PointT.
  • The PointT API is not a publicly guaranteed API and may change.
  • Version 0.5.0 should still be considered a public preview while additional
    installations are being verified.
  • Keep the official Bosch or Buderus app available for commissioning and
    service work.
  • Historical recordings and the separate shared-energy tariff service are
    intentionally not included yet.
  • Air conditioners, wallboxes, Matter/MQTT devices, gateway network
    administration, and local LAN communication are outside the current scope.
  • This project is not affiliated with or endorsed by Bosch, Buderus,
    Bosch Home Comfort, or Home Assistant.

Quality

The current release passes:

  • 451 automated tests
  • 95.20% branch coverage
  • Ruff formatting and linting
  • Strict Mypy type checking
  • Home Assistant hassfest validation
  • HACS repository validation
  • Dependency security auditing
  • Reproducible release packaging with a SHA-256 checksum

Feedback

Bug reports, compatibility reports, and carefully redacted diagnostics are
very welcome. Please use the repository’s Issues tab.

Please mention the brand, gateway model, heating-system type, number of
circuits, optional components, and Home Assistant version.

Do not publish passwords, tokens, complete authorization return addresses,
gateway IDs, full serial numbers, or unredacted account data.

The current stable release is v0.5.0 and is available from the repository’s
Releases section.

1 Like