Xiaomi, Mi, Deerma

Xiaomi Humidifier

homebridge-mi-humidifier · v2.4.6

VerifiedLocal

Adds Xiaomi Mi and Deerma humidifiers to HomeKit.

View on npm Source code

What it says it supports

Brands

Xiaomi
Mi
Deerma
Shuii

Devices it names

zhimi.humidifier.v1/ca1/cb1/ca4
deerma.humidifier models
shuii.humidifier.jsq001

Shows up in Apple Home as from its README

Sensor readings in its code

What people report

Works with SmartMi UV and Evaporative humidifiers; newer Xiaomi/Deerma models (mjjsq, jsq4 after firmware update, Humidifier 2) are commonly reported as not working.

Works1
Partly works3
Not working2
Requested1

Device	Status	What they said	Source
SmartMi Germicidal UV Humidifier	Works	Maintainer says it is known to work Saved copy Hi, It is known that it works with SmartMi Germocidal UV Humidifier (`zhimi.humidifier.v1`): and using some hacks (see this comment) with SmartMi Evaporative Humidifier (`zhimi.humidifier.ca1`): Excerpt saved from GitHub on 2026-10-22.	Issue #16 · 2019-10
SmartMi Evaporative Humidifier	Partly works	Works only with hacks per maintainer Saved copy Hi, It is known that it works with SmartMi Germocidal UV Humidifier (`zhimi.humidifier.v1`): and using some hacks (see this comment) with SmartMi Evaporative Humidifier (`zhimi.humidifier.ca1`): Excerpt saved from GitHub on 2026-10-22.	Issue #16 · 2019-10
Smartmi evaporative humidifier	Partly works	Works in Homebridge but getting the token is tricky Saved copy I recommend Smartmi/Xiaomi Evaporative humidifier if you can find it in UK. This one is a better solution than all the ultrasonic humidifier you can buy in my humble opinion! =) I got it working in Homebridge, but its a little tricky getting the token. Excerpt saved from Arctic Shift Reddit archive on 2026-10-22.	Reddit comment · 2022-02
Xiaomi humidifier MJJSQ04DY	Partly works	Timeouts after firmware update; region-switch workaround reportedly restored it Saved copy Hi, now I'm using a mjjsq04dy. And after the firmware update in Mi Home, I cannot control it via device profile deerma.humidifier.jsq4 (before update this profile properly work for on/off). Logs: `[10/16/2021, 8:33:48 PM] [homebridge-mi-humidifier] [ ] Fail to get device properties. SocketError: Timeout ` Excerpt saved from GitHub on 2026-10-22.	Issue #100 · 2021-10
Mijia Smart Sterilization Humidifier S ZNJSQ01DEM	Not working	EU global version fails; humidity value undefined despite trying models Saved copy Hi, i cant run my humidifier ZNJSQ01DEM EU (global version) can you please add support? I use Homebridge Raspberry Pi Image on Raspberry Pi zero WH. (all updated) [12/3/2021, 9:29:13 AM] [homebridge-mi-humidifier] This plugin generated a warning from the characteristic 'Current Relative Humidity': characteristic value expected valid finite number and received "undefined" (undefined). See https://git.io/JtMGR for more info. [12/3/2021, 9:29:13 AM] [homebridge-mi-humidifier] This plugin generated a warning from the characteristic 'Water Level': characteristic value expected valid finite number … Excerpt saved from GitHub on 2026-10-22.	Issue #106 · 2021-12
Xiaomi Mi Humidifier (deerma.humidifier.mjjsq)	Not working	Not supported by the miio library; user could not control it Saved copy Dear Russtone, Thank you for the reply. Sadly I have already bought one of the Xiaomi Humidifier and its miio model is deerma.humidifier.mjjsq which doesn't work with the plugin (or any as far as I tried). Wonder if you could have a plan on updating the plugin to work with this model? Up on googled, I found this information that might be useful somehow but since I know nothing about coding so I can't be sure of. It's mentioned by @rezmus `it's new mi humidifier, miio model deerma.humidifier.mjjsq https://www.xiaomiyoupin.com/detail?gid=109486 https://ibb.co/n1dwCgS while i don't have device … Excerpt saved from GitHub on 2026-10-22.	Issue #16 · 2019-10
Xiaomi Smart Humidifier 2	Requested	Support requested; one user's unit reports deerma.humidifier.jsq2w and build workaround failed Saved copy Hi @russtone, thanks for this great plugin - Xiaomi released the Smart Humidifier 2, model number: `MJJSQ05DY`, are you planning to add support for it? Happy to help create a PR once I receive my device: https://www.mi.com/global/product/xiaomi-smart-humidifier-2/ Excerpt saved from GitHub on 2026-10-22.	Issue #113 · 2022-09

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

Mi miIO protocol by IP and token

You’ll need

Device IP
Device token

Compatibility

Verified by Homebridge	Yes
Homebridge versions	>=0.4.38
Homebridge 2.0	No
Node.js	>=8.3.0
Settings in Homebridge UI	Yes
Matter	No
Platform name	MiHumidifier
License	MIT

Community signals

Downloads a week	8
Downloads a month	99
GitHub stars	62
Open issues	21
Closed issues	57
Last code push	2023-03-05
Latest version	2.4.6 (2023-02-06)
First published	2018-04-17
Releases	36

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.