Xiaomi Miot for Home Assistant (Marketplace integration)

Installs: 21.9k sharing analytics
GitHub stars: 6.2k
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v1.1.5, October 23, 2026
Category: Hubs and protocols, Smart home hubs
Kind: Marketplace integration
Brand: Xiaomi
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: xiaomi_miot
Source: github.com/al-one/hass-xiaomi-miot
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

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

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.

Provides

Lights
Climate
Water heaters
Humidifiers
Fans
Covers
Cameras
Alarms
Media
Remotes
Vacuums
Switches
Sensors
Presence

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 DeviceIn 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 DeviceIn 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.

Entities

Binary sensorsWater Shortage, Fault
ButtonsInfo
NumbersWater Interval
SelectsWater Mode
SensorsClean Area, Clean Time, Energy Today, Energy Month
SwitchesDo Not Disturb, Child Lock

Actions

Send commandSend miio commandFields: Entity ID, Method, Params
Get propertiesGet miot propertiesFields: Entity ID, Mapping, Update entity
Set propertySet miot propertyFields: Entity ID, Field, Value
Set miot propertySet miot property by siid/piidFields: Entity ID
Call actionCall miot actionFields: Entity ID
Intelligent speakerIntelligent speaker for XiaoAiFields: Entity ID, Text, Execute, Silent
XiaoAi WakeupWakeup the XiaoAi speakerFields: Entity ID, Text
Get device dataGet xiaomi device data from cloudFields: Entity ID, Type, Key, Time start, Time end, Limit, Group
Renew devicesRenew cached xiaomi devicesFields: Username
Get tokenGet xiaomi device tokenFields: Name
Get bindkeyGet bindkey for ble deviceFields: Entity ID, DID
Request xiaomi APIRequest xiaomi APIFields: Entity ID, API, Data, Method, Crypt

Troubleshooting

System healthAdds 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, Apache License 2.0. Shortened.