How do I install the Xiaomi Air Purifier skill?

Run npx skillmds add modbender/xiaomi-air-purifier in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Xiaomi Air Purifier safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Xiaomi Air Purifier?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Xiaomi Air Purifier free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Xiaomi Air Purifier?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Xiaomi Air Purifier by modbender — Agent Skill

Name: Xiaomi Air Purifier
Rating: 4.666666666666667 (3 reviews)
Author: modbender

Xiaomi Air Purifier

Monitor and control Xiaomi Air Purifier 4 Lite via Mi Cloud. Use when asked to check air quality, humidity, purifier status, turn on/off the air purifier, or change fan mode/level. Supports multi-room setups.

modbender aaaa82c 6 files · 56.0 KB Updated Sep 9, 2026 12 repo stars

File contents

Xiaomi Air Purifier Control

Control and monitor Xiaomi Air Purifier 4 Lite (zhimi.airp.rmb1) via Xiaomi Cloud API. Supports multiple devices and room-based targeting.

Setup

Install dependencies:

cd xiaomi-air-purifier && pnpm install

pnpm exec xmihome login -u <email/phone> -p <password> -c <country>

Supported countries: sg, ru, us, cn

List devices to verify discovery:

node scripts/purifier.js devices

Usage

Commands can be targeted by Room Name, Device Name, or DID. If no target is provided, it uses the selected default or the only available device.

node scripts/purifier.js status [room]      # Check status (e.g., status Bedroom)
node scripts/purifier.js status-full [room] # Show full status (incl. filter)
node scripts/purifier.js on [room]          # Power on
node scripts/purifier.js off [room]         # Power off
node scripts/purifier.js mode <0-2> [room]  # 0=Auto, 1=Sleep, 2=Favorite
node scripts/purifier.js level <0-14> [room]# Fan speed (Favorite mode)
node scripts/purifier.js brightness <0-2> [room]
node scripts/purifier.js buzzer <on|off> [room]
node scripts/purifier.js lock <on|off> [room]

Quick Reference

Property	siid	piid	Type	Description
Power	2	1	bool	On/Off
Mode	2	4	int	0=Auto, 1=Sleep, 2=Favorite
Humidity	3	1	int	Relative humidity (%)
PM2.5	3	4	int	Air quality (μg/m³)
Temperature	3	7	float	Temperature (°C)
Filter Life	4	1	int	Filter remaining (%)
Buzzer	6	1	bool	Notification sound on/off
Child Lock	8	1	bool	Physical button lock
Fan Level	9	11	int	0-14 (Favorite mode)
Brightness	13	2	int	0=Off, 1=Dim, 2=On

---name: xiaomi-air-purifierdescription: Monitor and control Xiaomi Air Purifier 4 Lite via Mi Cloud. Use when asked to check air quality, humidity, purifier status, turn on/off the air purifier, or change fan mode/level. Supports multi-room setups.--- # Xiaomi Air Purifier Control Control and monitor Xiaomi Air Purifier 4 Lite (`zhimi.airp.rmb1`) via Xiaomi Cloud API. Supports multiple devices and room-based targeting. ## Setup 1. Install dependencies: ```bash cd xiaomi-air-purifier && pnpm install ``` 2. Login to Mi Cloud (OTP will be sent via SMS/Email): ```bash pnpm exec xmihome login -u <email/phone> -p <password> -c <country> ``` Supported countries: `sg`, `ru`, `us`, `cn` 3. List devices to verify discovery: ```bash node scripts/purifier.js devices ``` ## Usage Commands can be targeted by **Room Name**, **Device Name**, or **DID**. If no target is provided, it uses the selected default or the only available device. ```bash node scripts/purifier.js status [room] # Check status (e.g., status Bedroom) node scripts/purifier.js status-full [room] # Show full status (incl. filter) node scripts/purifier.js on [room] # Power on node scripts/purifier.js off [room] # Power off node scripts/purifier.js mode <0-2> [room] # 0=Auto, 1=Sleep, 2=Favorite node scripts/purifier.js level <0-14> [room]# Fan speed (Favorite mode) node scripts/purifier.js brightness <0-2> [room] node scripts/purifier.js buzzer <on|off> [room] node scripts/purifier.js lock <on|off> [room] ``` ## Quick Reference | Property | siid | piid | Type | Description | |----------|------|------|------|-------------| | Power | 2 | 1 | bool | On/Off | | Mode | 2 | 4 | int | 0=Auto, 1=Sleep, 2=Favorite | | Humidity | 3 | 1 | int | Relative humidity (%) | | PM2.5 | 3 | 4 | int | Air quality (μg/m³) | | Temperature | 3 | 7 | float | Temperature (°C) | | Filter Life | 4 | 1 | int | Filter remaining (%) | | Buzzer | 6 | 1 | bool | Notification sound on/off | | Child Lock | 8 | 1 | bool | Physical button lock | | Fan Level | 9 | 11 | int | 0-14 (Favorite mode) | | Brightness | 13 | 2 | int | 0=Off, 1=Dim, 2=On |

Frequently asked questions