Integration · MQTT

Home Assistant

Native smart home integration. Every pollutant, auto-discovered.

ambient one integrates natively with Home Assistant via MQTT: no cloud dependency, no third-party plugins, no hacks.

See ambient one

In Home Assistant

12 sensors

All auto-discovered. No manual YAML required.

  • PM1.0Particulate matter
  • PM2.5Particulate matter
  • PM4.0Particulate matter
  • PM10Particulate matter
  • CO₂Carbon dioxide
  • VOC indexVolatile organic compounds
  • NOx indexNitrogen oxides
  • Temperature
  • Humidity
  • HCHOFormaldehyde · via Charging Dock Pro
  • IAQ Scoreambient's overall air quality score
  • AQIStandard air quality index

Published every minute as averaged readings

Why Home Assistant?

Home Assistant is the world's most popular open-source smart home platform, used by over a million people to control and automate their homes. If you already run it, ambient one slots right in. If you don't, it's worth a look.

With ambient one connected to Home Assistant, you can build automations that respond to your actual air quality: turn on a purifier when PM2.5 spikes, open a window when CO₂ is high, or trigger a fan when VOCs rise in your workshop.

Data is published every minute as averaged readings, so your Home Assistant graphs stay clean and meaningful, with no noise and no spikes from single readings.

A phone showing live ambient one readings in the Ambient Works app, with ambient one on the table behind it

How to set it up

Setting up ambient one with Home Assistant takes just a few minutes.

  1. Open the Ambient Works app on your phone.

  2. Go to Device Settings → MQTT.

  3. Enter your MQTT broker address (usually your Home Assistant IP).

  4. Save. ambient one connects and the sensors appear automatically.

That's it. Every pollutant shows up in Home Assistant under your device, ready to use in dashboards and automations.

MQTT defaults

Port
1883
Discovery prefix
homeassistant
Publish interval
60 seconds

If your MQTT broker uses authentication, you can enter your username and password in the app. Credentials are stored securely on the device.

Not using Home Assistant?

ambient one works with any MQTT broker: Mosquitto, EMQX, HiveMQ, or your own. You can subscribe to the device's MQTT topics from any client.

The auto-discovery messages follow the Home Assistant convention, but the raw sensor data is published as standard MQTT payloads.

Automation ideas

Here are some things people are doing with ambient one and Home Assistant.

ambient one on its orange handle on a workshop bench, with tools on a pegboard behind
  • Air purifier control

    When
    PM2.5 exceeds a threshold
    Then
    Turn on your purifier, and turn it off when the air is clean again
  • Ventilation

    When
    CO₂ rises above 1000 ppm
    Then
    Open smart vents or trigger an ERV/HRV
  • Workshop safety

    When
    VOC or formaldehyde levels spike during a work session
    Then
    Flash a smart light or send a notification
  • Sleep environment

    When
    You monitor bedroom air quality overnight
    Then
    Adjust a fan or humidifier based on the readings
  • Dashboard

    When
    You want air quality at a glance
    Then
    Build a wall-mounted display showing real-time air quality across every room
  • Data logging

    When
    You want the long view
    Then
    Store long-term air quality data in InfluxDB or another database for analysis

Privacy & local control

MQTT data from ambient one goes directly from the device to your broker. It doesn't pass through our cloud, so your air quality data stays on your network.

The MQTT connection works alongside the Ambient Works app and cloud dashboard. You can use both, or just MQTT if you prefer fully local control.