2025.4.0
Home ▸ Integrations ▸

AirGradient

The AirGradient integration will fetch data from your AirGradient devices. AirGradient creates indoor and outdoor air quality monitors that enable you 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.

Important

In order for the device to be set up or discovered by Home Assistant, the firmware version should be at least 3.1.1.

Configuration

To add the AirGradient device to your Home Assistant instance, use this My button:

AirGradient can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select AirGradient.

  • Follow the instructions on screen to complete the setup.

Host

The IP address or hostname for your AirGradient device.

Available sensors

The integration will fetch data from each device. The following sensors are supported:

  • Carbon dioxide
  • Humidity
  • Nitrogen index
  • PM0.3 count
  • PM1 density
  • PM2.5 density
  • PM10 density
  • Raw nitrogen
  • Raw total volatile organic compounds
  • Signal strength
  • Temperature
  • Total volatile organic compounds index

Available configuration entities

The integration provides a few configuration entities to customize the device experience. The settings are only available when the configuration source is set to local. The following entities are supported:

  • Display temperature unit
  • Display brightness
  • LED bar brightness
  • Requesting CO2 calibration
  • Requesting LED bar test
  • Toggling sharing metrics with AirGradient

Remove integration

This integration follows standard integration removal, no extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.