Xiaomi Gateway 3 for Home Assistant (Marketplace integration)

Installs: 3.2k sharing analytics
GitHub stars: 2.8k
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v4.3.0, October 15, 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_gateway3
Source: github.com/AlexxIT/XiaomiGateway3
Issues: Report an issue

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

Screenshots From the README of AlexxIT/XiaomiGateway3.

About

Home Assistant custom component for control Xiaomi Multimode Gateway (aka Gateway 3), Xiaomi Multimode Gateway 2, Aqara Hub E1 on default firmwares over LAN

Description from AlexxIT/XiaomiGateway3

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Device triggers Its devices can start automations directly.
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
Covers
Alarms
Switches
Sensors

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

Host
Token
Key

Add Mi Cloud Account

Email / Mi Account ID
Password
Servers

Verify account

Code

Also asked when at the verify account step.

After setup

Device
Host
Token
Key
Open Telnet command
Support Bluetooth devices
Add statistic sensors
Debug logs

Texts from the code of AlexxIT/XiaomiGateway3.

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

Home Assistant custom component for control Xiaomi Multimode Gateway (aka Gateway 3), Xiaomi Multimode Gateway 2, Aqara Hub E1 on default firmwares over LAN.
Other. Aqara Hub E1 (EU), Aqara G2H (CN), Aqara H1 (CN), Aqara M1S (CN), Aqara M2 (CN), Aqara P3 (CN) | HE1-G01, ZNSXJ12LM, QBCZWG11LM, ZHWG15LM, ZHWG12LM, KTBL12LM - no, goto

From the README of AlexxIT/XiaomiGateway3, MIT License. Shortened.