---
title: "Xiaomi Gateway (Aqara)"
description: "Xiaomi Gateway (Aqara) is a built-in integration for Home Assistant. It has 2.5k installs sharing analytics and works locally."
canonical: "https://vulpo.app/integrations/core/xiaomi-aqara"
url: "https://vulpo.app/integrations/core/xiaomi-aqara.md"
last-updated: "2026-10-23"
version: "1.4"
---

# Xiaomi Gateway (Aqara)

> Xiaomi Gateway (Aqara) is a built-in integration for Home Assistant. It has 2.5k installs sharing analytics and works locally.

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=xiaomi_aqara)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Found by itself**: Home Assistant spots it on the network and offers to add it.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services.

### Connect

- **IP address (optional)**
- **The network interface to use**
- **MAC address (optional)**

### Choose a device

- **IP address**

### Optional settings

- **The key of your Gateway**
- **Name of the Gateway**

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Actions

- **Add device**: Enables the join permission of the Xiaomi Aqara Gateway for 30 seconds. A new device can be added afterwards by pressing the pairing button once.
  Fields: Gateway MAC
- **Play ringtone**: Plays a specific ringtone. The version of the gateway firmware must be 1.4.1\_145 at least.
  Fields: Gateway MAC, Ringtone ID, Ringtone volume
- **Remove device**: Removes a specific device. The removal is required if a device shall be paired with another gateway.
  Fields: Device ID, Gateway MAC
- **Stop ringtone**: Stops a playing ringtone immediately.
  Fields: Gateway MAC

## At a glance

- Kind: Built-in 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: 2.5k installs sharing analytics
- Connection: Works locally
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Domain: `xiaomi_aqara`
- Source: <https://www.home-assistant.io/integrations/xiaomi_aqara/>

In Vulpo: Light card, Quick Toggle card, Cover card, Lock card, Apple Watch, Control Center

## 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/core/xiaomi-aqara

---

- HTML version of this page: https://vulpo.app/integrations/core/xiaomi-aqara
- 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