Skip to content
Home Assistant TestFlight
Climate

myVAILLANT

signalkraft/mypyllant-component · vv0.9.19

HACSCloud polling

Home Assistant component for the myVAILLANT API, controls Vaillant devices such as aroTHERM heatpumps and ecoTEC boilers

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

EntityShows up asNote
switchSwitch or outlet
climateThermostat
binary_sensorSensor (motion, contact, leak, smoke…)
sensorSensor (temperature, humidity, air quality…)
water_heaterWater heater (as a thermostat)

What people report

Vaillant myVAILLANT cloud integration works for VRC700, ambiSENSE and aroTHERM, with occasional API outages and sensor regressions. No local API exists.

  • Works2
  • Partly works3
  • Not working1
  • Requested1
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Vaillant ambiSENSE room devicesWorks CloudRoom climate entities plus battery low and reachable binary sensors
Saved copy
For each ambisense devices, this PR adds: - one binary_sensor for battery_low (`false` = OK, `true` = battery low) - one binary_sensor for unreach (`false` = unreachable, `true` = OK). Tested with my steup (with ambisense). It could be nice if it could be tested without ambisense

Excerpt saved from GitHub on 2026-10-23.

PR #219 · 2024-10
Vaillant sensoCOMFORT VRC700 ventilationWorks CloudFan mode fix merged for DAY/SET_BACK
Saved copy
Problem On VRC700 controllers (e.g. sensoCOMFORT) `climate.set_fan_mode` fails for the ventilation entity for every mode except `auto`. Each call returns a 500 in Home Assistant because the myVAILLANT API rejects the request: [code] ### Root cause `async_set_fan_mode` resolves the operation mode with `[k for k, v in self.fan_mode_map.items() if v == fan_mode][0]`. The VRC700 `fan_mode_map` maps both `NORMAL → FAN_ON` and `DAY → FAN_ON` (and `REDUCED → FAN_LOW`, `SET_BACK → FAN_LOW`). `[0]` therefore picks `NORMAL` / `REDUCED`, which the VRC700 ventilation endpoint does not accept. I verified …

Excerpt saved from GitHub on 2026-10-23.

PR #456 · 2026-06
Vaillant aroTHERM heat pump with VRC700Partly works CloudTemperature control fixes proposed but PR closed unmerged
Saved copy
Summary This PR fixes three separate issues that prevented temperature control from working on VRC700 systems (e.g. Vaillant aroTHERM heat pump with VRC700 controller). It was developed with the assistance of Claude AI (Anthropic), which helped diagnose the issues, write the fixes, and reverse engineer the missing cooling API endpoint. ### Fix 1, VRC700 heating DAY mode not recognised as manual setpoint `ZoneOperatingModeVRC700.DAY` is the VRC700 equivalent of a fixed/manual heating setpoint, but `async_set_temperature` only checked for `ZoneOperatingMode.MANUAL` (non-VRC700). This caused …

Excerpt saved from GitHub on 2026-10-23.

PR #446 · 2026-05
Vaillant heat pump (Apple Home native)Partly works CloudNative HomeKit is local and controls heat pump but not water heater part
Saved copy
Apple's homekit integration is local. And it can control our Vaillant heat pump. Not possible to control the water heater part.

Excerpt saved from GitHub on 2026-10-23.

Issue #350 · 2025-08
Vaillant VRC700 controller with VR921 gatewayPartly works CloudNeeds beta releases; presets other than eco did not work; later fixes merged
Saved copy
Hello, after a mandatory migration to myvaillant (I used Multimatic before), I installed this component to continue using my heater in HA. After installation, I notice that no sensor is present, here are the messages I see in the log: This is the error detail of the VRC700 line: Cette erreur provient d'une intégration personnalisée Logger: custom_components.mypyllant Source: helpers/update_coordinator.py:313 Integration: myVAILLANT (documentation, issues) First occurred: 20:47:44 (2 occurrences) Last logged: 20:47:45 Unexpected error fetching myVAILLANT data: 'DAY' is not a valid …

Excerpt saved from GitHub on 2026-10-23.

Issue #104 · 2024-02
Vaillant aroTHERM plus heat pumpNot working CloudDaily energy sensors only report exact 1000 Wh multiples since Sept 2026
Saved copy
Integration version: v0.9.19 (latest available via HACS, no pending update) Home Assistant Core: 2026.9.1 Device: aroTHERM plus heat pump ## Problem Since 2026-09-05, both `consumed_electrical_energy_heating` and `consumed_electrical_energy_domestic_hot_water` (and the corresponding `heat_generated_*` sensors) only ever report values that are exact multiples of 1000 Wh (i.e. whole kWh, 0, 1000, 2000, 3000 Wh), never any value with the granularity I'd expect from a real energy meter (e.g. 1247, 1832 Wh). The daily reset itself works correctly (resets to 0.0 around 22:00 UTC / midnight …

Excerpt saved from GitHub on 2026-10-23.

Issue #490 · 2026-09
Vaillant geoCOMPACT VWS 5.2/8.1 iQ (iQconnect)Requested CloudiQconnect scf devices invisible; support in open PR
Saved copy
Adds support for iQconnect-generation Vaillant devices (control identifier `scf`, product type `VR_NEEXT`, e.g. geoCOMPACT VWS 5.2/8.1 iQ). Today these aren't visible: `/homes` returns them but the aggregate `System` endpoint 404s, so 0 entities. Rebased onto current `main` (`myPyllant==0.9.18`, no manifest change needed). `scf` is native in the base library since signalkraft/myPyllant#160, so no runtime enum patching is needed here. With signalkraft/myPyllant#161 (merged) `get_systems()` also skips `scf` homes itself, so the split in the coordinator is belt-and-braces rather than …

Excerpt saved from GitHub on 2026-10-23.

PR #468 · 2026-07

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Cloud polling

Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.

Details

Installs (analytics)3,824 (0.54%)
GitHub stars346
Latest versionv0.9.19 (2026-07-22)
Set up in the UIYes
Maintainers@signalkraft
LicenseMIT

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

ForkStarsLast pushDescription
rmalbrecht/VaillantCloud★ 42025-10-27Home Assistant component for the myVAILLANT API, controls Vaillant devices such as aroTHERM heatpumps and ecoTEC boilers

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.