Home Assistant

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

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.

ambient one publishes 12 sensors to Home Assistant, all auto-discovered — no manual YAML required:

• PM1.0, PM2.5, PM4.0, PM10 — particulate matter
• CO₂ — carbon dioxide
• VOC index — volatile organic compounds
• NOx index — nitrogen oxides
• Temperature
• Humidity
• HCHO — formaldehyde (via Charging Dock Pro)
• IAQ Score — ambient's overall air quality score
• AQI — standard air quality index

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

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 sensors appear automatically

That's it. Every pollutant will show 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.

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

• Air purifier control — Turn on your purifier automatically when PM2.5 exceeds a threshold, turn it off when the air is clean again
• Ventilation — Open smart vents or trigger an ERV/HRV when CO₂ rises above 1000 ppm
• Workshop safety — Flash a smart light or send a notification when VOC or formaldehyde levels spike during a work session
• Sleep environment — Monitor bedroom air quality overnight and adjust a fan or humidifier based on readings
• Dashboard — Build a wall-mounted display showing real-time air quality across every room
• Data logging — Store long-term air quality data in InfluxDB or another database for analysis

MQTT data from ambient one goes directly from the device to your broker — it doesn't pass through our cloud. 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.