Back to the overview

Xiaomi BLE in Home Assistant

xiaomi_ble part of Home Assistant since 2022.8

Local, push Set up in the user interface

Xiaomi BLE is an official Home Assistant integration for Binary sensor, Event and Sensor. Talks to the device on your own network and is told about every change straight away.

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, push – Talks to the device on your own network and is told about every change straight away.
Setup
in the user interface
Kind
Single device
Installations
27,613 (4.0 % of the installations that share statistics)
Categories
Binary sensor, Event, Sensor
Provides
Binary sensor, Event, Sensor
Found automatically via
Bluetooth
Maintained by
@Jc2k, @Ernst79
Python packages
xiaomi-ble==1.16.1

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for Xiaomi BLE.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Known issues and fixes

7 open issues and 3 bug fixes in the last twelve months are recorded for Xiaomi BLE in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.5.0.

Open

  • open Reported problem #148914 since July 16, 2025 · 20 reactions · 32 comments · #148914
  • open Reported problem #111139 since February 22, 2024 · 4 reactions · 30 comments · #111139
  • open Reported problem #170474 since May 13, 2026 · 2 reactions · 4 comments · #170474
  • open Reported problem #179701 since August 21, 2026 · 1 reaction · 4 comments · #179701
  • open Reported problem #181954 since September 11, 2026 · 0 reactions · 3 comments · #181954
  • open Reported problem #172028 since May 24, 2026 · 0 reactions · 3 comments · #172028
  • open Reported problem #176100 since July 9, 2026 · 0 reactions · 1 comment · #176100

Fixed

Source: the issue tracker of Home Assistant, as of September 14, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration

Scroll to Top