Are you concerned about the VOC air quality in your home? Would you like to monitor it without spending a fortune? If so, you’re in luck! In this guide, I’ll show you how to make your own air quality smart sensor for Home Assistant for less than $5 and in just 10 minutes. We’ll be using a sensor called the AGS10, which may sound complicated, but this DIY project is straightforward and easy to follow.

Why Monitor Air Quality?

Before we dive into the steps, let’s talk about why this sensor is important. The AGS10 is a volatile organic compound (VOC) sensor. VOCs are chemicals found in many household products, such as candles, perfumes, cleaning products, craft supplies like glue and paint, cooking fumes, and even some children’s toys. High levels of VOCs can pose health risks, including respiratory irritation, headaches, and other symptoms. Therefore, having a VOC sensor can help you maintain a healthier indoor environment.

Prefer Watching Video?

If you don’t want to read more then please check my video tutorial about this topic.

Parts You’ll Need for the VOC Air Quality Sensor

To build this smart air quality sensor, you only need four components, and you might already have some of them:

I’m sharing some affiliate links below to all the parts and if you buy something from these links I’ll get a small commission from your purchases with no additional cost for you.

  1. AGS10 Sensor: This VOC sensor costs from $1.50 to $3 on AliExpress.
  2. D1 Mini ESP8266: The brain of the operation, costing less than $3 on AliExpress.
  3. Jumper Wires: To connect the AGS10 to the D1 Mini.
  4. Micro USB Cable: For powering the D1 Mini and uploading the ESPHome code.

Software Requirements

You’ll need Home Assistant, preferably with the Add-on Store, and the ESPHome dashboard. The ESPHome dashboard can be installed as a Home Assistant add-on, making the setup process smooth.

If you don’t have Home Assistant yet, consider registering for my free Home Assistant webinar

Step-by-Step Guide

Step 1: Wiring the Sensor

Here’s how to wire the AGS10 sensor to the D1 Mini:

  1. Connect the VIN pin on the AGS10 to the 3V3 pin on the D1 Mini.
  2. Connect the GND pin on the AGS10 to the G pin on the D1 Mini.
  3. Connect the SCL pin on the AGS10 to the D1 pin on the D1 Mini.
  4. Connect the SDA pin on the AGS10 to the D2 pin on the D1 Mini.
Correctly wired VOC Air Quality Sensor
Correctly wired VOC Air Quality Sensor

Step 2: Uploading ESPHome Code

Now, let’s upload the ESPHome code to the D1 Mini.

  1. Open your Home Assistant and go to the Add-on Store.
  2. Install the ESPHome add-on, then click on “Start”.
  3. Open the ESPHome dashboard by clicking “Open Web UI”.
  4. Click on “New Device” and follow the prompts. Name your device (e.g., “VOC Air Quality”), select the board type (ESP8266 for the D1 Mini), and skip the initial configuration.
  5. Edit the configuration by adding the following code to the bottom of the existing ESPHome code (add new line at the very bottom and paste the code below there):

  sda: 4
  scl: 5
  scan: True
  frequency: 10kHz

  port: 80

  - platform: ags10
    update_interval: 1s
      name: TVOC
  1. Save the configuration and connect the D1 Mini to your Home Assistant device using a micro USB cable.
  2. Click on “Install” and select “Plug into the computer running ESPHome Dashboard”. This will upload the code to your D1 Mini.

Step 3: Adding the Sensor to Home Assistant

  1. Go to the Integrations page in Home Assistant.
  2. You should see a new device (your VOC air quality sensor) ready to be configured. Click on “Configure” and then “Submit”.
  3. Once configured, you can find the sensor in your ESPHome section under configured devices.

Step 4: Creating Automations

Now that your sensor is set up, you can create automations based on its readings. For example, you can set up notifications if VOC levels exceed a certain threshold.

  1. Go to the Automations page in Home Assistant and create a new automation.
  2. Set the trigger to “Volatile Organic Compounds Concentration changed” and set a threshold value (e.g., 400 ppb).
  3. Add actions, such as sending a persistent notification in Home Assistant and a message via Telegram (additional configuration needed – Home Assistant Telegram Notifications (Video How-To)).

Here’s an example configuration for the automation:

alias: the VOCs are over 400
description: ""
  - type: volatile_organic_compounds_parts
    platform: device
    device_id: 5b79cd9f1bcc334d9edc1fa7e8cc796c
    entity_id: 3f4456a88745912e17e91a5216e33801
    domain: sensor
    above: 400
condition: []
  - service: persistent_notification.create
    metadata: {}
      message: the VOCs are over 400
  - service: notify.telegram
    metadata: {}
      message: the VOCs are over 400
mode: single

Testing the Sensor

To test your sensor, use a product that emits VOCs, like nail polish remover or aftershave. Place the sensor near the product and monitor the readings in Home Assistant. If everything is set up correctly, you should see the VOC levels rise and receive notifications when they exceed your set threshold.


Congratulations! You’ve just built a DIY air quality smart sensor for less than $5. This sensor can help you monitor and maintain healthy indoor air quality, giving you peace of mind.

Feel free to download my Smart Home Glossary which is coming as one big PDF file and it is full of Smart Home Wisdom 🙂 Oh, and it is free.

Thank you for reading, and happy DIY-ing!


Leave a Reply

Avatar placeholder

Your email address will not be published. Required fields are marked *