About
UniFi Protect Air Quality is a local integration for Ubiquiti UP-AirQuality sensors connected to a UniFi Protect console. It talks directly to the console, so MQTT, a cloud account and an extra bridge are not needed. Each sensor shows up as a device with readings for air quality index, carbon dioxide, humidity, temperature, particulate matter, VOC, NOx and vape. Every metric also has an alarm binary sensor, and an event entity reports when an alarm starts or ends, which can be used as an automation trigger. Settings can be changed from Home Assistant, including LED ring, night mode, vape sensitivity, and low and high alarm thresholds per metric. NOx entities are disabled by default, since some firmware does not provide a usable reading, and setup is done in the UI.
Automatic summary of the README and code of mvs90/ha-unifi-air-quality. Something wrong, or are you the maintainer and want your own text here? Get in touch
Shows in Vulpo
Quick Toggle card, Select card, Chart card, Apple Watch, Control Center.Installs over time
#1,604 of 1,626 Marketplace integrations. Installs sharing analytics.
Supports
- Works locallyTalks to your devices on your own network. No vendor cloud in between.
- From the MarketplaceInstalled through the Marketplace, formerly HACS.
- Actively maintainedIts author released or pushed a change in the last six months.
Provides
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Connect to UniFi Protect
- HostHostname or IP address only, without https://.
- Port
- Local username
- Password
- Verify TLS certificateEnable only when Home Assistant trusts the console certificate.
Reauthenticate with UniFi Protect
- Password
Texts from the code of mvs90/ha-unifi-air-quality.
Entities
- Binary sensorsAir quality index alarm, Carbon dioxide alarm, Humidity alarm, Temperature alarm, PM1 alarm, PM2.5 alarm, PM4 alarm, PM10 alarm, TVOC alarm, VOC alarm, NOx alarm, Vape alarm
- EventsAir quality alarm event
- NumbersLED ring brightness, Night mode brightness, Vape sensitivity, AQI low threshold, AQI high threshold, Carbon dioxide low threshold, Carbon dioxide high threshold, Humidity low threshold, Humidity high threshold, PM1 low threshold, PM1 high threshold, PM2.5 low threshold, and 14 more
- SelectsLED ring metric
- SensorsAir quality index, Carbon dioxide, Humidity, Temperature, PM1, PM2.5, PM4, PM10, Total volatile organic compounds, VOC index, NOx index, Vape index
- SwitchesStatus light, LED ring, Activity feedback, Night mode, Vape detection, AQI alerts, Carbon dioxide alerts, Humidity alerts, PM1 alerts, PM2.5 alerts, PM4 alerts, PM10 alerts, and 5 more
- TimesNight mode start, Night mode end
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
An experimental, local-push Home Assistant custom integration for the UniFi Protect UP-AirQuality sensor. It communicates directly with the console; MQTT, a cloud account, and an additional bridge are not required.
Information
- Installs
- 51 sharing analytics
- GitHub stars
- 13
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v0.5.4,
- Category
- Security and safety, Cameras
- Kind
- Marketplace integration
- Brand
- Ubiquiti
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
unifi_air_quality- Issues
- Report an issue
More from Ubiquiti
You might also like
Try it with your own Home Assistant.

- Free to download
- iPhone, iPad, Mac and Apple Watch
- 40+ native card types
- Connects to your own Home Assistant

















