Skip to content

On Home Assistant 2026.10 or older? Open it in HACS

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

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

51+51 in 30 daysNew
Nov 4Nov 20

#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.

From the README of mvs90/ha-unifi-air-quality, MIT License. Shortened.

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
Needs
Needs the Marketplace (HACS on 2026.10 and older)
Domain
unifi_air_quality

More from Ubiquiti

You might also like

Try it with your own Home Assistant.

Vulpo on a MacBook, a Studio Display, an iPhone, an iPad and an Apple Watch.
  • Free to download
  • iPhone, iPad, Mac and Apple Watch
  • 40+ native card types
  • Connects to your own Home Assistant

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. About these numbers

New in 2026.11: HACS becomes the Home Assistant Marketplace, what changes.

Looking for an app? The best Home Assistant apps for iPhone, by need.