Dyson
libdyson-wg/ha-dyson · vv1.5.7
Home Assistant custom integration for Wi-Fi connected Dyson devices
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 | |
humidifier | Humidifier or dehumidifier | |
camera | Camera | Needs its own HomeKit Bridge in accessory mode |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
vacuum | Vacuum (as a switch) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
6 reports below say how a device from this integration behaves in the Home app.
What people report
Dyson purifiers, fans and heaters work locally over LAN MQTT after a one-time cloud setup, with new models added by the maintainers. The 360 Vis Nav vacuum stopped working after a Dyson firmware update.
- Works6
- Partly works6
- Requested1
- Won’t be supported1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Dyson 527M purifier | Works | Support added via libdyson-neon upgradeSaved copyThe original text was already deleted or overwritten when we archived it. | PR #259 · 2025-07 | |
| Dyson air purifier | Works | Said to integrate with Home AssistantSaved copyDyson integrates with HA. https://preview.redd.it/fv5dyib9wp2c1.jpeg?width=1290&format=pjpg&auto=webp&s=07e7ec6baf074caa50ed5bd751209b52b6d0bf2f Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2023-11 | |
| Dyson Pure Cool | Works Local | Added locally by usersSaved copyHaving the same problem, I have and old Dyson pure cool (`438`) that I've been able to add locally. I also have a regular Purifier Humidify+Cool that I can't add. The `get_devices.py` out put is as follows: [code] Is there already some workaround to add the device while it's fixed properly? Excerpt saved from GitHub on 2026-10-23. | Issue #8 · 2023-04 | |
| Dyson Purifier Hot+Cool Formaldehyde HP09 (527K) | Works Local | Supported since v0.18.0 with local interview; formaldehyde models need cloud for initial setupSaved copyHi there! Supporting Formaldehyde fans is definitely something we are working on adding soon. You can check my comment on a pull request for more information: https://github.com/libdyson-wg/libdyson-neon/pull/7#issuecomment-1501923127 But the short version, copied from that comment: > Properly supporting Formaldehyde models actually happens to be one of the things I want to solve with a light refactor I'm working on right now. The challenge here is this: Dyson dealt us a tricky hand with their product codes for Formaldehyde models. The code 527K is correct for BOTH the Formaldehyde and … Excerpt saved from GitHub on 2026-10-23. | Issue #8 · 2023-04 | |
| Dyson Purifier Humidify+Cool Formaldehyde 358K | Works | Support added and fixed in early 2023Saved copyThe original text was already deleted or overwritten when we archived it. | PR #11 · 2023-04 | |
| Dyson TP04 / TP02 purifiers | Works | Initial filter life reset supportSaved copyThe original text was already deleted or overwritten when we archived it. | PR #79 · 2023-10 | |
| Dyson air purifier HP04 | Partly works | Broken in Home Shows as switch with sub-accessories, not an air purifier | Fan exposed as multiple switches after 2025.5 purifier supportSaved copyThe problem Last 2025.5 Home Assistant release introduced the possibility to expose fans as air purifiers through the HomeKit bridge. My Dyson purifiers are exposed as switches, with multiple sub accessories inside HomeKit, instead of Air Purifiers. ### What version of Home Assistant Core has the issue? 2025.5.0 ### What was the last working version of Home Assistant Core? _No response_ ### What type of installation are you running? Home Assistant OS ### Integration causing the issue HomeKit Bridge ### Link to integration documentation on our website _No response_ ### Diagnostics information … Excerpt saved from GitHub on 2026-10-23. | Issue #144460 · 2025-05 |
| Dyson dehumidifier (ha-dyson) | Partly works | Partly in Home Invalid dehumidifier state error logged when exposed | Custom component exposes invalid state to HomeKit; error on loadSaved copyThe problem I see an error in the logs when HomeKit attempts to load the `ha-dyson` custom component. Logging here in case the issue lies with core; if it's determined that this is a problem with the custom component, let me know and I'll log with that author. ### What version of Home Assistant Core has the issue? core-2021.12.3 ### What was the last working version of Home Assistant Core? ? ### What type of installation are you running? Home Assistant Container ### Integration causing the issue HomeKit ### Link to integration documentation on our website … Excerpt saved from GitHub on 2026-10-23. | Issue #62240 · 2021-12 |
| Dyson DP04 fan | Partly works Cloud | Partly in Home Speed list lacks 'off', warning and odd speed mapping | Detected, but speeds low/medium/high lack an off valueSaved copy… (Hass.io/Docker/Windows/etc.): Manual install on Raspberry Pi Component/platform: https://github.com/home-assistant/home-assistant/tree/dev/homeassistant/components/dyson Description of problem: When starting up Home Assistant my two Dyson DP04 are detected but it throws the following error: `[homeassistant.components.homekit.util] ['low', 'medium', 'high'] does not contain the speed setting off as its first element. Assuming that low is equivalent to 'off'.` Actually it should be off and speeds 1 to 10 (which I can later see in the speed list of my Dyson fan, still the dev tool doesn't allow … Excerpt saved from GitHub on 2026-10-23. | Issue #24613 · 2019-06 |
| Dyson fan | Partly works | Partly in Home Fan speed control errors; missing standard speed mapping | Fan lacks standard SPEED_OFF/low/medium/high mappingSaved copy… Core release (if known): - Operating environment (Home Assistant/Supervised/Docker/venv): Docker, Supervised - Integration causing this issue: Homekit/Dyson fan/Xiaomi air purifier - Link to integration documentation on our website: HomeKit: https://www.home-assistant.io/integrations/homekit/ Dyson fan: https://www.home-assistant.io/integrations/dyson/ Xiaomi air purifier: https://www.home-assistant.io/integrations/fan.xiaomi_miio/ ## Problem-relevant `configuration.yaml` [code] ## Traceback/Error logs ```txt Logger: homeassistant.components.homekit.util Source: components/homekit/util.py:234 … Excerpt saved from GitHub on 2026-10-23. | Issue #35580 · 2020-05 |
| Dyson Hot+Cool Link | Partly works | Partly in Home Fan controls work in Home app; humidity and air quality sensors missing | Sensors not in HomeKit supported listSaved copyUnable to add Dyson Hot+Cool Link sensors on Homekit I have configured the bridge by the Integration UI to add the Dyson Hot+Cool Link control on the Home App. The fan works well and I am able to switch to hot/cool, oscillate, set the fan speed. But I can't add the dyson sensors like humidity or air quality to homekit even if I check the 'sensors' checkbox on the bridge setup UI... ## Environment - Home Assistant Core release with the issue: HassOS 4.10 - Last working Home Assistant Core release (if known): N/A - Operating environment (OS/Container/Supervised/Core): N/A - Integration causing … Excerpt saved from GitHub on 2026-10-23. | Issue #37155 · 2020-06 |
| Dyson Pure/Hot+Cool Link fan sensors | Partly works | Partly in Home Humidity sensor was fixed; air quality needs device_class workaround to appear | Fan, heat/cool, oscillation work; air quality reports VOC not PM2.5Saved copyThe problem Dyson integration does not expose humidity or air quality (pm25) to homekit by default ## Environment - Home Assistant Core release with the issue: 2020.12.1 - Last working Home Assistant Core release (if known): - Operating environment (OS/Container/Supervised/Core): Mac OSX Catalina 10.15.7 - Integration causing this issue: Dyson - Link to integration documentation on our website: https://www.home-assistant.io/integrations/dyson/ ## Problem-relevant `configuration.yaml` [code] ## Traceback/Error logs [code] ## Additional information The dyson integration works perfectly within … Excerpt saved from GitHub on 2026-10-23. | Issue #44648 · 2020-12 |
| Dyson HushJet Purifier Compact HJ10 | Requested | Pending PR maps cloud type 897 to a Pure Cool deviceSaved copySummary Adds support for the Dyson HushJet Purifier Compact HJ10 (cloud ProductType `897`, model prefix `M4P`). - Maps `897` / `HJ10` / `M4P` to a `DysonPureCool` instance via a local `get_device` wrapper, so this works without changes to libdyson-neon - Custom fan entity with speed and preset mode only, no oscillation or direction, as the HJ10 doesn't support either - Sensors limited to PM 2.5, PM 10, and filter life, the HJ10 has no humidity, temperature, VOC, or NO₂ sensors - Speed commands sent as a single MQTT message to avoid the device resetting to max speed Tested on a real HJ10 … Excerpt saved from GitHub on 2026-10-23. | PR #321 · 2026-04 | |
| Dyson 360 Vis Nav | Won’t be supported Local | Worked locally until Dyson firmware update blocked the LAN MQTT methodSaved copyHi @moonmelon1. Unfortunately Vis Nav was supported until Dyson disabled the connection method we use in a firmware update. This integration uses MQTT to communicate directly with the device over LAN. After a firmware update last year, the Vis Nav stopped accepting MQTT Connections and now only seems to work via the cloud connection, which is not used in this integration. I don't currently have plans to add cloud connectivity features unless it becomes required for more devices. I'll mark this topic as closed, but please feel free to follow up if you have any questions. You can also check out … Excerpt saved from GitHub on 2026-10-23. | Issue #257 · 2025-06 |
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 push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Details
| Installs (analytics) | 4,721 (0.67%) |
|---|---|
| GitHub stars | 441 |
| Latest version | v1.5.7 (2025-08-15) |
| Set up in the UI | Yes |
| Maintainers | @libdyson-wg, @dotvezz, @cmgrayb |
| 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 |
|---|---|---|---|
| Sean-StarLabs/ha-dyson Newer code | ★ 1 | 2026-01-07 | Home Assistant custom integration for Wi-Fi connected Dyson devices |
| willvanwazer/ha-dyson Newer code | ★ 0 | 2026-02-27 | Home Assistant custom integration for Wi-Fi connected Dyson devices |
| weiyuericlee/ha-dyson Newer code | ★ 0 | 2026-08-24 | Home Assistant custom integration for Wi-Fi connected Dyson devices |
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/libdyson-wg/ha-dyson
- Source code: https://github.com/libdyson-wg/ha-dyson
- Issues: https://github.com/libdyson-wg/ha-dyson/issues
- HACS: https://hacs.xyz