Blueair
dahlb/ha_blueair · vv1.57.1
Home Assistant Integration for Blueair
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 |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
climate | Thermostat | |
fan | Fan | |
humidifier | Humidifier or dehumidifier | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) |
2 reports below say how a device from this integration behaves in the Home app.
What people report
Blueair purifiers and humidifiers work via cloud with MQTT updates on newer units. HomeKit Bridge shows false low-battery on PM2.5 sensor and a Night fan preset.
- Works4
- Partly works4
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Blueair 511i Max | Works Cloud | Model name added (SKU 111582)Saved copyCurrently work on adding 511i Max and other missing skus: https://github.com/philjn/blueair_api/tree/feature/sku-model-names and corresponding add-on changes: https://github.com/philjn/ha_blueair/pull/new/feature/sku-model-names Excerpt saved from GitHub on 2026-10-23. | Issue #329 · 2026-04 | |
| Blueair air purifier | Works | HACS integration works wellSaved copyHappy with Blueair! There is a HACS integration for it that works well. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2025-02 | |
| Blueair i35 humidifier | Works Cloud | NoneType comparison errors fixedSaved copy… yet thus the property is None. But because it is apparently called by all of the actions (maybe unintionally?) all actions fail with this type error on i35. I tested with this fix fan on/off and led on off works with an i35. Excerpt saved from GitHub on 2026-10-23. | PR #136 · 2024-11 | |
| Blueair purifier fans | Works Cloud | Partly in Home Night preset adds extra fan in Home app; option removes it | Option to hide Night preset on fansSaved copyAdds an option, "Offer the Night preset on fans" (on by default, so nothing changes unless you turn it off), that leaves `night` out of the fans' preset modes. Why: HA's HomeKit Bridge gives every fan preset except `auto` its own switch in Apple Home, with no way to leave one out. For anyone who never uses Night, that's a switch per purifier that does nothing useful and is easy to hit by accident. Turning this off leaves the purifier with just its Auto/Manual control in Home. - Applies to every fan in the config entry: the legacy fan, the AWS fan, and the Signature and combo preset lists. - … Excerpt saved from GitHub on 2026-10-23. | PR #428 · 2026-10 |
| Blueair air purifier PM2.5 sensor | Partly works Cloud | Partly in Home Shows false Low Battery warning on PM2.5 sensor | Filter life exposed as battery levelSaved copy… not a duplicate feature request of previous feature requests. ### Is your feature request related to a problem? Please describe. Describe the bug The PM2.5 sensor exposed via HA's HomeKit Bridge integration shows a "Low Battery" warning in HomeKit/Home app. The sensor has no battery, this appears to be a false positive caused by a missing `battery_level` attribute on the entity, which HomeKit interprets as a dead battery when pairing an air quality sensor with the battery service characteristic. To reproduce 1. Install ha_blueair and configure a device with a PM2.5 sensor 2. Expose the PM2.5 … Excerpt saved from GitHub on 2026-10-23. | Issue #332 · 2026-04 |
| Blueair CP7i | Partly works Cloud | Region selection PR open for accounts provisioned elsewhereSaved copy… cloud region selection to the config flow so accounts whose Gigya login region differs from the region their hardware is actually provisioned in (e.g. CP7i devices) can be controlled. Builds on the region-discovery primitives shipped in `blueair-api==1.53.0`. Works toward #312. Most accounts use the same region for login and device control and are unaffected, discovery runs automatically and, when one online region is clear, setup completes with no extra prompt. ## What changes - Config entry schema v3 with a silent `v2 -> v3` migration that seeds `cloud_region = region` for existing entries … Excerpt saved from GitHub on 2026-10-23. | PR #372 · 2026-06 | |
| Blueair Dreamwell H38i | Partly works Cloud | Sensors and fan show but support incompleteSaved copy@dahlb I just got a H76i, the two gallon big brother of the H38i. Let me know if you need anything from me to get support for this unit working. I have a first-gen H35i that works great with your integration. Excerpt saved from GitHub on 2026-10-23. | Issue #283 · 2025-11 | |
| Blueair H76i humidifier | Partly works Cloud | Fan speed control not working properlySaved copyBump. I own the H76i. I see the same Fan control, temp/humidity and online status sensors, but the fan speed control is not working properly. I also bought this model and am not able to use the fan control of the humidifier. Excerpt saved from GitHub on 2026-10-23. | Issue #283 · 2025-11 |
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) | 1,176 (0.17%) |
|---|---|
| GitHub stars | 124 |
| Latest version | v1.57.1 (2026-10-21) |
| Set up in the UI | Yes |
| Maintainers | @dahlb |
| License | MIT |
Limitations from the README
- If you receive an error while trying to login, try resetting your password to one with no special characters except '!' and no longer then 10 characters.
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/dahlb/ha_blueair
- Source code: https://github.com/dahlb/ha_blueair
- Issues: https://github.com/dahlb/ha_blueair/issues
- HACS: https://hacs.xyz