Cielo Home
bodyscape/cielo_home · v1.9.5
Integration with Cielo Home
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 | |
fan | Fan | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
2 reports below say how a device from this integration behaves in the Home app.
What people report
Cloud push control of Cielo Breez and MRCOOL units; Breez Lite fan control through HomeKit Bridge fails and the cloud login has had outages.
- Works2
- Partly works2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Cielo Breez Max | Works Cloud | Follow-me and preset mode support addedSaved copyThis should address issue #64 Hi @bodyscape, this change enables preset selection with Breez Max, but honestly I'm not very proud of the code, it feels hack-ish with all the `if BREEZE_MAX`, depending on how different these devices work at the API level, it may be worth to refactor cielohomedevice in specialized classes. Please, let me know if this patch is acceptable as it is otherwise provide me some guidance on how you would prefer the "logic fork" to be implemented. Please, keep in mind I only tested it on a Breez Max, as that's the only device I have access too Excerpt saved from GitHub on 2026-10-23. | PR #67 · 2024-07 | |
| MRCOOL units (BI03/BI04) | Works Cloud | Turbo mode fix covers BI03 and BI04 device typesSaved copyRef issue: #63 Most recent version 1.7.7 accommodates fix for Turbo mode on MRCOOL devices, but only the old device type, `BI03`. This PR also supports new device type `BI04`. New device type, for example MRCOOL DIY Series Outtasight Ceiling Cassette (Model: DIYCASSETTEHP-230C25) are labeled as device type `BI04` This fix has been confirmed working for several users. Excerpt saved from GitHub on 2026-10-23. | PR #75 · 2024-12 | |
| Cielo Breez Lite | Partly works Cloud | Broken in Home Fan cannot be controlled in Home app via HomeKit Bridge | Climate entity works; fan speed cased Low/Medium/High mismatches Apple lowercaseSaved copyWhen the climate entity is exposed via a Breez Lite's HomeKit Bridge, the fan cannot be controlled. Excerpt saved from GitHub on 2026-10-23. | Issue #108 · 2026-05 |
| Cielo climate in HomeKit (fractional Fahrenheit) | Partly works Cloud | Partly in Home HomeKit fractional Fahrenheit targets truncated to unsupported values | Target temperature rounding fix for HomeKit-converted values is pendingSaved copySummary - quantize requested temperatures to the appliance's advertised minimum/maximum/step grid before unit conversion - avoid truncating HomeKit-converted fractional Fahrenheit values to unsupported integers - add focused tests for Fahrenheit and Celsius grids, range clamping, midpoint behavior, and invalid steps ## Reproduction A HomeKit request displayed as 72 F reaches Home Assistant as approximately 71.6 F. The integration previously converted that to int immediately, sent 71 F to an appliance advertising a 64-88 F range with a 2 F step, and the Cielo state later reverted to the prior … Excerpt saved from GitHub on 2026-10-23. | PR #122 · 2026-08 |
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 push
Goes through the maker’s cloud, which sends updates as they happen. Needs the internet and an account.
Details
| Installs (analytics) | 427 (0.06%) |
|---|---|
| GitHub stars | 76 |
| Latest version | 1.9.5 (2026-07-13) |
| Set up in the UI | Yes |
| Maintainers | @bodyscape |
| License | Apache-2.0 |
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/bodyscape/cielo_home
- Source code: https://github.com/bodyscape/cielo_home
- Issues: https://github.com/bodyscape/cielo_home/issues
- HACS: https://hacs.xyz