Kumo
dlarrick/hass-kumo · vv0.4.6
Home Assistant module interfacing with Mitsubishi mini-split units
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 |
|---|---|---|
climate | Thermostat | |
sensor | Sensor (temperature, humidity, air quality…) |
What people report
Mitsubishi Kumo units are controlled locally once the cloud login fetches their passwords; accounts migrated to the Comfort app and legacy WF-2 adapters often fail setup.
- Works1
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Mitsubishi Kumo indoor units (Comfort app) | Works Local | Setup works when HA is on the same network as the units; v3 API supportedSaved copyAdd basic unit tests Add pre-commit with ruff formatting Expand list of MACs to probe Add Home Assistant diagnostics capability Excerpt saved from GitHub on 2026-10-23. | PR #222 · 2026-05 | |
| Mitsubishi Kumo WF-2 adapter (Comfort account) | Not working Cloud | V3 login succeeds but server returns no unit passwords; setup failsSaved copySeeing the same failure mode, at 0/4 instead of 0/1. Environment: hass-kumo v0.4.6 (HACS), Home Assistant 2026.9.1, Mitsubishi Comfort app account, 4 units. Debug log (custom_components.kumo + pykumo set to debug): 21:25:52 INFO [pykumo.py_kumo_cloud_account_v3] V3 login successful 21:25:53 INFO [pykumo.py_kumo_cloud_account_v3] V3 API: found 4 devices 21:25:54 DEBUG [pykumo.py_kumo_cloud_account_v3] Socket.IO connected, sid=Yzh_Xmhe0XhKt72HcIr3 21:26:56 INFO [pykumo.py_kumo_cloud_account_v3] Socket.IO: found passwords for 0/4 devices (10 polls) 21:26:56 INFO [pykumo.py_kumo_cloud_account_v3] … Excerpt saved from GitHub on 2026-10-23. | Issue #233 · 2026-09 |
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
Local polling
Talks to the device on your network, asking it for updates every so often.
Found automatically over
- DHCP
Details
| Installs (analytics) | 289 (0.04%) |
|---|---|
| GitHub stars | 141 |
| Latest version | v0.4.6 (2026-10-04) |
| Set up in the UI | Yes |
| Maintainers | @dlarrick |
| License | MIT |
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.
Sources
- Documentation: https://github.com/dlarrick/hass-kumo
- Source code: https://github.com/dlarrick/hass-kumo
- Issues: https://github.com/dlarrick/hass-kumo/issues
- HACS: https://hacs.xyz
