myVAILLANT
signalkraft/mypyllant-component · vv0.9.19
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.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
climate | Thermostat | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
water_heater | Water 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
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Vaillant ambiSENSE room devices | Works Cloud | Room climate entities plus battery low and reachable binary sensorsSaved copyFor 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 ventilation | Works Cloud | Fan mode fix merged for DAY/SET_BACKSaved copyProblem 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 VRC700 | Partly works Cloud | Temperature control fixes proposed but PR closed unmergedSaved copySummary 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 Cloud | Native HomeKit is local and controls heat pump but not water heater partSaved copyApple'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 gateway | Partly works Cloud | Needs beta releases; presets other than eco did not work; later fixes mergedSaved copyHello, 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 pump | Not working Cloud | Daily energy sensors only report exact 1000 Wh multiples since Sept 2026Saved copyIntegration 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 Cloud | iQconnect scf devices invisible; support in open PRSaved copyAdds 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 stars | 346 |
| Latest version | v0.9.19 (2026-07-22) |
| Set up in the UI | Yes |
| Maintainers | @signalkraft |
| License | MIT |
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.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| rmalbrecht/VaillantCloud | ★ 4 | 2025-10-27 | Home 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.