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.
In Home Assistant
12 sensorsAll 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.
How to set it up
Setting up ambient one with Home Assistant takes just a few minutes.
-
Open the Ambient Works app on your phone.
-
Go to Device Settings → MQTT.
-
Enter your MQTT broker address (usually your Home Assistant IP).
-
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.
-
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.