--- title: "Xiaomi Mi Air Purifier, Air Humidifier, Air Fresh and Pedestal Fan Integration" description: "Xiaomi Mi Air Purifier, Air Humidifier, Air Fresh and Pedestal Fan Integration is a Marketplace integration for Home Assistant. It has 331 installs sharing analytics, works locally and was last updated October 1, 2026." canonical: "https://vulpo.app/integrations/marketplace/syssi-xiaomi-airpurifier" url: "https://vulpo.app/integrations/marketplace/syssi-xiaomi-airpurifier.md" last-updated: "2026-10-23" version: "1.4" --- # Xiaomi Mi Air Purifier, Air Humidifier, Air Fresh and Pedestal Fan Integration > Xiaomi Mi Air Purifier, Air Humidifier, Air Fresh and Pedestal Fan Integration is a Marketplace integration for Home Assistant. It has 331 installs sharing analytics, works locally and was last updated October 1, 2026. Xiaomi Mi Air Purifier, Air Humidifier, Air Fresh and Pedestal Fan Integration adds Xiaomi air devices to Home Assistant. It talks to the devices locally and is configured in the YAML configuration file, using an access token retrieved from the device. It provides climate and fan entities, with power, preset modes such as auto, silent and favorite, and a favorite level setting. Actions cover the buzzer, child lock, LED brightness, fan level, volume, and resetting the filter lifetime and usage. Humidifier models get a target humidity action and a dry mode switch. Exposed attributes include temperature, humidity, air quality index and filter life remaining, which vary by model. The README describes it as a beta version of the component in Home Assistant Core that also supports additional devices. Automatic summary of the README and code of syssi/xiaomi\_airpurifier. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=syssi&repository=xiaomi_airpurifier&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=syssi&repository=xiaomi_airpurifier&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant. It is then set up in configuration.yaml. ## Actions - **Set buzzer on**: Turn the buzzer on. Fields: Entity ID - **Set buzzer off**: Turn the buzzer off. Fields: Entity ID - **Set child lock on**: Turn the child lock on. Fields: Entity ID - **Set child lock off**: Turn the child lock off. Fields: Entity ID - **Set favorite level**: Set the favorite level. Fields: Entity ID, Level - **Set fan level**: Set the fan level. Fields: Entity ID, Level - **Set LED brightness**: Set the LED brightness. Fields: Entity ID, Brightness - **Set auto detect on**: Turn the auto detect on. Fields: Entity ID - **Set auto detect off**: Turn the auto detect off. Fields: Entity ID - **Set learn mode on**: Turn the learn mode on. Fields: Entity ID - **Set learn mode off**: Turn the learn mode off. Fields: Entity ID - **Set volume**: Set the sound volume. Fields: Entity ID, Volume - **Reset filter**: Reset the filter lifetime and usage. Fields: Entity ID - **Set extra features**: Manipulates a storage register which advertises extra features. The Mi Home app evaluates the value. A feature called "turbo mode" is unlocked in the app on value 1. Fields: Entity ID, Features - **Set target humidity**: Set the target humidity. Fields: Entity ID, Humidity - **Set dry on**: Turn the dry mode on. Fields: Entity ID - **Set dry off**: Turn the dry mode off. Fields: Entity ID - **Set filters cleaned**: Inform the device that filters are cleaned. Fields: Entity ID ## From the README > This is a custom component for home assistant to integrate the Xiaomi Mi Air Purifier 2, Air Purifier 2S, Air Purifier Pro, Air Humidifier, Air Fresh and Pedestal Fan. > > Please follow the instructions on Retrieving the Access Token to get the API token to use in the configuration.yaml file. > > - Power (on, off) > - Preset modes (auto, silent, favorite, idle) > - Buzzer (on, off) > - Child lock (on, off) > - LED (on, off), LED brightness (bright, dim, off) > - Favorite Level (0...16) > - Attributes > - model > - temperature > - humidity > - aqi > - mode From the README of [syssi/xiaomi\_airpurifier](https://github.com/syssi/xiaomi_airpurifier#readme), [Apache License 2.0](https://spdx.org/licenses/Apache-2.0.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Climate](https://vulpo.app/integrations/category/climate.md), Fans and ventilation - Brand: [Xiaomi](https://vulpo.app/integrations/xiaomi.md) - Number: 331 installs sharing analytics; 499 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: 2026.6.0.0, last updated October 1, 2026 - Domain: `xiaomi_miio_airpurifier` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/a7eecdb4a4549f0d.webp (from syssi/xiaomi\_airpurifier's README) In Vulpo: Climate card, Fan card, Apple Watch, Climate Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) ## Other ways in for Xiaomi | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Xiaomi BLE](https://vulpo.app/integrations/core/xiaomi-ble.md) | Built-in integration | 28.1k installs sharing analytics | Works locally | Part of Home Assistant | | [Xiaomi Miot](https://vulpo.app/integrations/marketplace/al-one-hass-xiaomi-miot.md) | Marketplace integration | 21.9k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Xiaomi Home](https://vulpo.app/integrations/marketplace/xiaomi-ha-xiaomi-home.md) | Marketplace integration | 20.2k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Xiaomi Home](https://vulpo.app/integrations/core/xiaomi-miio.md) | Built-in integration | 11.6k installs sharing analytics | Works locally | Part of Home Assistant | | [Xiaomi Cloud Map Extractor](https://vulpo.app/integrations/marketplace/piotrmachowski-home-assistant-custom-components-xiaomi-cloud-map-extractor.md) | Marketplace integration | 3.4k installs sharing analytics | Needs the vendor's cloud | No update in 6 to 18 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-23. Source: https://vulpo.app/integrations/marketplace/syssi-xiaomi-airpurifier --- - HTML version of this page: https://vulpo.app/integrations/marketplace/syssi-xiaomi-airpurifier - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml