Xiaomi

Xiaomi Air Purifier

homebridge-xiaomi-air-purifier-modern · v1.0.9

LocalHomebridge 2.0

Adds Xiaomi Mi Air Purifier 2H, 3, 3H, 4 and Pro to HomeKit over the local miIO protocol.

View on npm Source code

What it says it supports

Brands

Xiaomi

Devices it names

Mi Air Purifier 2H
Mi Air Purifier 3
Mi Air Purifier 3H
Mi Air Purifier 4
Mi Air Purifier Pro

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Xiaomi air purifiers; zhimi.airpurifier.3 user hit config UI bug fixed in 1.0.4.

Works1

Device	Status	What they said	Source
Xiaomi Air Purifier zhimi.airpurifier.3	Works	Fixed after config UI bug in 1.0.4 Saved copy Plugin version 1.0.3 Purifier model zhimi.airpurifier.3 Homebridge version 2.0.2 Node.js version 22.21.1 Steps to reproduce Install plugin Add device info Save button is still greyed out with warning flag next to it that the config could not be validated. Each form field (name, ip, model, token) are all entered and individual validated. Excerpt saved from GitHub on 2026-10-22.	Issue #194 · 2026-05

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local

Local UDP 54321

You’ll need

Device token
Homebridge 2.0.2+
Node 22.12+

Compatibility

Verified by Homebridge	No
Homebridge versions	^2.0.2
Homebridge 2.0	Yes
Node.js	^22.12.0 \|\| ^24.0.0
Settings in Homebridge UI	Yes
Matter	No
Platform name	XiaomiMiAirPurifier
License	MIT

Community signals

Downloads a week	96
Downloads a month	248
GitHub stars	2
Open issues	0
Closed issues	1
Last code push	2026-10-16
Latest version	1.0.9 (2026-09-11)
First published	2026-05-05
Releases	10

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.