About
Dyson is an unofficial integration that connects Dyson fans, purifiers, heaters, humidifiers, lights and robot vacuums to Home Assistant. It communicates locally over MQTT, and some lights and floor-cleaning vacuums connect over Bluetooth, including through Bluetooth proxies. Devices can be found through a Dyson cloud account or added manually using details from the device sticker, with an optional static IP address. It covers many platforms, including fans, climate, humidifiers, lights, vacuums, sensors for air quality, switches, selects, calendars, images such as a dust map and floor plan, and firmware updates. Actions are provided for sleep timers, oscillation angles, scheduled operation, resetting filter life and fetching cloud account data for troubleshooting. Home Assistant can also discover devices on the network and show a repair notice when a device is unreachable.
Automatic summary of the README and code of cmgrayb/hass-dyson. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Lights
- Climate
- Humidifiers
- Fans
- Vacuums
- Switches
- Sensors
- Calendars
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Dyson Integration Setup
- Setup Method
Confirm the device
- Add this device to Home Assistant
Dyson Account Authentication
- Email or Mobile (CN: +8613800000000)
Manual Device Setup
- Device Serial Number
- Device Password
- MQTT Prefix (e.g., 438, 475, 455)
- Device IP Address (optional - leave blank for auto-discovery)
- Device Name (Optional)
- Device Categories (select all that apply to your device)
- Device Capabilities (select features to enable)
Email OTP Verification
- Verification Code
- Password
Mobile OTP Verification
- Verification Code
Connection Preferences
- Connection Type
Cloud Account Settings
- Poll for new devices (check for new devices in your account periodically)
- Automatically add discovered devices (when disabled, devices will appear as discoverable but require manual approval)
After setup
- Action
- Confirm reload
- Confirm removal
- Device Serial
- Connection Type
- Connection Type
- Poll for new devices (check for new devices in your account periodically)
- Automatically add discovered devices (when disabled, devices will appear as discoverable but require manual approval)
Texts from the code of cmgrayb/hass-dyson.
Entities
- Binary sensorsAction required, Filter Replacement, Charging, Cleaning Solution, Motion, Actively Charging, Charger Present, Blockage, Filter Missing, Filter Needs Washing, System Error, Charge Required, and 3 more
- ButtonsFind+Follow Scan, Reconnect, Refresh Zone List
- CalendarsSchedule
- ImagesDust Map, Floor Plan
- LightsLight
- NumbersSleep Timer, Oscillation Low Angle, Oscillation High Angle, Oscillation Center Angle, Oscillation Angle
- SelectsFan Control Mode, Oscillation, Tilt, Heating Mode, Water Hardness, Power Level, Brush Bar Speed, Dust Illumination Mode, Machine UI Language, Cleaning mode (all rooms)
- SensorsActive fault, Clean duration, Clean action, Temperature, Humidity, PM2.5, PM10, Particulates, VOC, NO2, CO2, HCHO, and 27 more
- SwitchesTask Detection, Auto Mode, Night Mode, Oscillation, Heating, Continuous Monitoring, Firmware Auto Update, Find+Follow, Daylight Mode, Battery Care
- UpdatesFirmware Update, Firmware
Actions
- Set Sleep TimerFields: Device, Minutes
- Cancel Sleep TimerFields: Device
- Schedule OperationFields: Device, Schedule Time, Operation
- Set Oscillation AnglesFields: Device, Lower Angle, Upper Angle
- Fetch Account DataFetch device data from Dyson cloud account for troubleshooting.Fields: Device
- Reset Filter LifeFields: Device, Filter Type
- Refresh Account DataFields: Device
- Get Cloud DevicesFields: Account Email, Sanitize Data
Troubleshooting
- Repair noticesNotices it can show in Settings, Repairs:Is not reachable at its configured address
From the README
A core-ready Home Assistant integration for Dyson air purifiers, heaters, humidifiers, fans, lights, and robotic vacuums featuring real-time MQTT communication, BLE proxy compatibility, and complete platform coverage.
Shows in Vulpo
Light card, Quick Toggle card, Climate card, Fan card, Apple Watch, Control Center, Climate Live Activity, Vacuum Live Activity.Information
- Installs
- 2k sharing analytics
- GitHub stars
- 120
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v0.38.0,
- Category
- Climate, Air purifiers and humidifiers
- Kind
- Marketplace integration
- Brand
- Dyson
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
hass_dyson- Issues
- Report an issue
