Xiaomi Air Purifier and Home Assistant: Step-by-Step Guide

What you’ll achieve with Xiaomi air purifier and Home Assistant

Integrating a Xiaomi air purifier with Home Assistant lets you monitor indoor air quality in real time, automate purification during high pollution moments, and control the purifier from a single dashboard. This combination reduces manual toggling and helps maintain a consistent indoor environment without constantly checking multiple apps. According to Air Purifier Info, the Xiaomi Miio-based setup offers reliable local control and responsive sensor data for most supported devices. The Air Purifier Info team found that common sensors exposed by compatible purifiers include PM2.5 levels, overall air quality index (AQI), temperature, and humidity. While model-specific differences exist, the core advantage remains: centralized management with clear visibility of air quality trends over time.

Compatibility and prerequisites

Before you start, confirm that your Xiaomi purifier model supports local API access via the Miio protocol. Ensure the purifier and your Home Assistant hub are on the same local network and that your Home Assistant installation is up to date. You should also decide whether you’ll use the UI-based setup or YAML-based configuration, and plan which sensors you want exposed for dashboards and automations. Having a static IP for the purifier simplifies reconnection if you ever reconfigure your network. Finally, allocate time for testing, since some devices require a brief pairing window to exchange credentials.

Setting up the integration

In Home Assistant, go to Settings > Devices & Services > Integrations, then click Add Integration and search for Xiaomi Miio. Enter the purifier’s IP address and (if prompted) the device token. When the device is discovered, you’ll see multiple entities such as dust level (PM2.5), AQI, temperature, and humidity. If LAN mode is required by your model, enable it as described in the purifier’s documentation and Home Assistant resources. After saving, restart Home Assistant to ensure all entities come online. Consider naming the entities clearly (e.g., living_room_purifier_pm25) to keep dashboards readable.

Exposing sensors and entities

Once integrated, confirm which entities are present in Home Assistant. Common examples include sensor.pm25, sensor.aqi, sensor.temperature, and sensor.humidity. You can customize the entity naming convention to match your room layout (e.g., kitchen_purifier_pm25). Create a simple Lovelace card that shows a real-time gauge for PM2.5, a line chart for AQI over time, and a small status indicator for device health. This visibility forms the basis for confident automation decisions.

Automations and practical examples

Automations save time by reacting to air quality changes without manual input. Example automations include:

• When AQI rises above a threshold, automatically turn on purification at a higher fan speed.
• If PM2.5 remains elevated overnight, enable a quiet mode to minimize noise while maintaining air cleaning.
• Schedule daily morning checks to ensure the purifier resets to a standard operation mode after the night.

Combining device triggers with time-based conditions yields a robust system that adapts to both daily routines and environmental fluctuations. Always test automations with a dry run to confirm actions occur as expected.

Monitoring and data visibility

Create a dedicated dashboard that aggregates purifier data with other air-quality sensors throughout the home. Use a mix of numeric gauges, trend graphs, and status chips to show real-time PM2.5, AQI, temperature, and humidity. Log data to a history graph for weekly and monthly analyses, helping you identify patterns (e.g., weekends with higher indoor activity or seasonal shifts). Regularly review dashboards to adjust thresholds as needed and keep the system aligned with your comfort goals.

Troubleshooting common issues

If the purifier is not discovered, verify the device is on the same LAN and that the IP address hasn’t changed. Double-check LAN mode settings and any required tokens. If readings are missing, ensure the purifier supports the exposed sensors for Miio integration and restart Home Assistant. For intermittent connectivity, set a static IP and confirm firewall rules don’t block the local API. If automations fire incorrectly, inspect triggers and conditions for conflicts or overlapping automations.

Maintenance, updates, and security

Regularly update both Home Assistant and the purifier’s firmware as updates become available. Clear device caches and re-run the integration setup after firmware updates if sensors stop reporting. Consider restricting remote access to your Home Assistant instance via VPN or a secure reverse proxy rather than exposing the Miio interface directly to the internet. Maintain strong network security practices to protect your automations and data.

Best practices and final notes

Document device names, sensor mappings, and automation logic to simplify future maintenance or expansion to additional purifiers. Start with a minimal, reliable setup and gradually introduce more automations as you validate performance. Remember that local control minimizes cloud dependencies, reducing latency and potential outages—an important consideration for homeowners prioritizing reliability.