AirGradient
airgradient
The AirGradient integration will fetch data from your AirGradient devices. AirGradient creates indoor, outdoor, and portable air quality monitors that enable you to know if the air quality is healthy or not. They measure metrics such as PM2.5, CO2, TVOCs, and NOx. Both the software and hardware are open-source, allowing you to customize or extend the device functionality.
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 | |
sensor | Sensor (CO₂, PM10, PM2.5, humidity, temperature) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
AirGradient monitors work locally; the new AirGradient Go was added in 2026. An I-9PSL stopped connecting when its temperature unit came back null.
- Works1
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| AirGradient Go | Works Local | Support addedSaved copyBreaking change None. ## Proposed change <!-- Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull request. If it fixes a bug or r Excerpt saved from GitHub on 2026-10-23. | PR #179543 · 2026-08 | |
| AirGradient I-9PSL | Not working Local | Config returns null temperatureUnit and offlineMode; integration refuses to connectSaved copy… working version of Home Assistant Core? _No response_ ### What type of installation are you running? Home Assistant OS ### Integration causing the issue airgradient ### Link to integration documentation on our website https://www.home-assistant.io/integrations/airgradient/ ### Diagnostics information `mashumaro.exceptions.InvalidFieldValue: Field "temperature_unit" of type TemperatureUnit in Config has invalid value None 2025-05-01 03:27:01.472 ERROR (MainThread) [homeassistant.components.airgradient] Unexpected error fetching AirGradient 192.168.2.99 data Traceback (most recent call last): … Excerpt saved from GitHub on 2026-10-23. | Issue #144039 · 2025-05 |
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 polling
Talks to the device on your network, asking it for updates every so often.
Found automatically over
- Bonjour (zeroconf)
Details
| Installs (analytics) | 2,679 (0.38%) |
|---|---|
| Quality scale | Platinum |
| Added in | Home Assistant 2024.6 |
| Set up in the UI | Yes |
| Maintainers | @airgradienthq, @joostlek |
Limitations from the docs
- The update entity is not able to install updates automatically. You will need to reboot the device manually after installing the update.
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.
