--- title: "Xiaomi Miot" description: "Xiaomi Miot is a Marketplace integration for Home Assistant. It has 21.9k installs sharing analytics, needs the vendor's cloud and was last updated October 23, 2026." canonical: "https://vulpo.app/integrations/marketplace/al-one-hass-xiaomi-miot" url: "https://vulpo.app/integrations/marketplace/al-one-hass-xiaomi-miot.md" last-updated: "2026-10-22" version: "1.4" --- # Xiaomi Miot > Xiaomi Miot is a Marketplace integration for Home Assistant. It has 21.9k installs sharing analytics, needs the vendor's cloud and was last updated October 23, 2026. Xiaomi Miot connects Xiaomi devices to Home Assistant using the miot-spec protocol, covering Wi-Fi, BLE and ZigBee devices. Devices can be added with a Xiaomi account, or with a local IP address and token for devices that support miot-spec over the local network. Account setup offers automatic, local or cloud connection modes, and the device list can be filtered by model, home or Wi-Fi network. The integration needs the vendor's cloud for some connections and is configured through the UI, with no YAML required for basic use. It creates many entity types, including sensors, switches, climate, cameras, vacuums, fans, lights and media players. Actions allow sending miio commands, reading and setting miot properties, calling device actions, fetching device tokens and BLE bindkeys, and waking a XiaoAi speaker. It polls devices for state, so it cannot catch real-time events from some wireless switches and motion or door sensors. Automatic summary of the README and code of al-one/hass-xiaomi-miot. 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=al-one&repository=hass-xiaomi-miot&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=al-one&repository=hass-xiaomi-miot&category=integration) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **Works with Assist**: Brings its own voice commands to Home Assistant's Assist. - **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, then add it under Settings, Devices and services. ### Select Action - **Action** ### Enter the token - **Local IP** - **Token** - **Device name** - **Update state interval (seconds)** ### Cloud - **Xiaomi Account ID / Email** - **Password** - **Captcha** - **Two-factor verification code** - **Server location of MiCloud** - **Connection mode for device** - **Translation property value description** - **Filter devices via model/home/WiFi (Advanced)** ### Filter cloud devices - **Filter Device Model** - **Device Model List** - **Filter Home** - **Home List** - **Filter WiFi SSID** - **WiFi SSID List** - **Filter WiFi BSSID** - **WiFi BSSID List** - **Filter Device**: In the exclude mode, if you do not check any option in the list, it is equivalent to including all devices. - **Device List** - **Filter Home (Leave blank to save)**: After checking this option and submitting, you will return to the current page, and the device list will refresh and filter out the devices of the checked homes. ### Customizing entities / devices - **Select entity domain** - **Select entity** - **Select device model** - **Specified device model (Optional)** - **Only main (parent) entities** - **YAML Mode** - **Customizes YAML Code** - **Reset to default customizes** - **binary\_sensor\_attributes** - **binary\_sensor\_properties** - **bind\_sensor** - **bind\_xiaoai** - **brightness\_for\_off** - **brightness\_for\_on** - **button\_actions** ### Xiaomi reauth — enter account password - **Password** ### Xiaomi reauth — enter verification code - **Verification ticket** ### Xiaomi reauth — enter captcha - **Captcha** ### After setup - **Device IP** - **Token** - **Status update interval (seconds)** - **Enable miot cloud (Config account in YAML first)** - **Xiaomi Account ID / Email** - **Password** - **Captcha** - **Two-factor verification code** - **Server location of MiCloud** - **Connection mode for device** - **Force renew devices** - **Translation property value description** - **Disable Mihome notification sensor** - **Disable Mihome scene history sensor** - **Filter Device Model** - **Device Model List** - **Filter Home** - **Home List** - **Filter WiFi SSID** - **WiFi SSID List** - **Filter WiFi BSSID** - **WiFi BSSID List** - **Filter Device**: In the exclude mode, if you do not check any option in the list, it is equivalent to including all devices. - **Device List** - **Filter Home (Leave blank to save)**: After checking this option and submitting, you will return to the current page, and the device list will refresh and filter out the devices of the checked homes. Texts from the code of [al-one/hass-xiaomi-miot](https://github.com/al-one/hass-xiaomi-miot). ## Entities - **Binary sensors**: Water Shortage, Fault - **Buttons**: Info - **Numbers**: Water Interval - **Selects**: Water Mode - **Sensors**: Clean Area, Clean Time, Energy Today, Energy Month - **Switches**: Do Not Disturb, Child Lock ## Actions - **Send command**: Send miio command Fields: Entity ID, Method, Params - **Get properties**: Get miot properties Fields: Entity ID, Mapping, Update entity - **Set property**: Set miot property Fields: Entity ID, Field, Value - **Set miot property**: Set miot property by siid/piid Fields: Entity ID - **Call action**: Call miot action Fields: Entity ID - **Intelligent speaker**: Intelligent speaker for XiaoAi Fields: Entity ID, Text, Execute, Silent - **XiaoAi Wakeup**: Wakeup the XiaoAi speaker Fields: Entity ID, Text - **Get device data**: Get xiaomi device data from cloud Fields: Entity ID, Type, Key, Time start, Time end, Limit, Group - **Renew devices**: Renew cached xiaomi devices Fields: Username - **Get token**: Get xiaomi device token Fields: Name - **Get bindkey**: Get bindkey for ble device Fields: Entity ID, DID - **Request xiaomi API**: Request xiaomi API Fields: Entity ID, API, Data, Method, Crypt ## Troubleshooting - **System health**: Adds its status to Home Assistant's system information. ## From the README > MIoT-Spec: The protocol specification for Xiaomi IoT devices, is a standard designed by the Xiaomi IoT platform to describe the function definition of hardware products according to the networking mode of hardware products, the characteristics of product functions, the characteristics of user usage scenarios and the user's requirements for hardware product use experience specification. > > This component uses the miot protocol to automatically integrate Xiaomi devices into HomeAssistant, and currently supports most Xiaomi IoT devices. And it supports HA Web UI, and you can easily integrate Xiaomi devices into HA without configuring yaml. From the README of [al-one/hass-xiaomi-miot](https://github.com/al-one/hass-xiaomi-miot#readme), [Apache License 2.0](https://spdx.org/licenses/Apache-2.0.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Hubs and protocols](https://vulpo.app/integrations/category/hubs-and-protocols.md), Smart home hubs - Brand: [Xiaomi](https://vulpo.app/integrations/xiaomi.md) - Number: 21.9k installs sharing analytics; 6.2k GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.1.5, last updated October 23, 2026 - Domain: `xiaomi_miot` - Source: - Issues: In Vulpo: Light card, Quick Toggle card, Cover card, Climate card, Apple Watch, Control Center, Climate Live Activity (Pro), Vacuum 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 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 | | [Xiaomi Gateway 3](https://vulpo.app/integrations/marketplace/alexxit-xiaomigateway3.md) | Marketplace integration | 3.2k installs sharing analytics | Works locally | Updated in the last 6 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-22. Source: https://vulpo.app/integrations/marketplace/al-one-hass-xiaomi-miot --- - HTML version of this page: https://vulpo.app/integrations/marketplace/al-one-hass-xiaomi-miot - 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