# Aqara

Read and control Aqara smart home devices: plugs, switches, lights, AC, locks...

- Repository: https://github.com/Anil-matcha/awesome-muse-connectors (1403 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Anil-matcha/awesome-muse-connectors --skill aqara -g -a claude-code -y`
Codex: `npx skills add Anil-matcha/awesome-muse-connectors --skill aqara -g -a codex -y`
Cursor: `npx skills add Anil-matcha/awesome-muse-connectors --skill aqara -g -a cursor -y`
Gemini CLI: `npx skills add Anil-matcha/awesome-muse-connectors --skill aqara -g -a gemini-cli -y`

## Description

Read and control Aqara smart home devices: plugs, switches, lights, AC, locks, curtains, scenes. Trigger phrases: aqara, aqara hub, aqara lock, aqara curtain.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Aqara

## Purpose
Read device attributes and send control commands to Aqara devices through the
Aqara Open Cloud API: plugs and wall switches, lights (brightness, color
temperature), air conditioners, supported locks, curtain motors, and saved
scenes, organized by homes and rooms. Use it when the user asks about or wants
to change anything in their Aqara setup. Zigbee devices need an Aqara hub
online. Commands drive real physical hardware, so writes are
confirmation-gated (see Operating Rules).

## Tooling
All commands go through `bin/aqara.py`. `--region` picks the regional host
(`open-<region>.aqara.com`, e.g. `us`, `eu`, `cn`; default `us`).

**Every path below is UNTESTED.** The exact REST path form and the request
signature headers could not be pinned from public docs at build time (see
Operating Rules, open items). Verify every command against the official
OpenAPI reference on first live use before trusting it.

```bash
bin/aqara.py auth --region us                         # UNTESTED: status check, list homes
bin/aqara.py homes --region us                        # UNTESTED: list homes
bin/aqara.py rooms --home <home_id> --region us       # UNTESTED: list rooms
bin/aqara.py devices --home <home_id> --region us     # UNTESTED: list devices
bin/aqara.py status --device <device_id> --region us  # UNTESTED: read device attributes

# Writes (all UNTESTED paths). Lock endpoints are HIGH: --confirm on every run:
bin/aqara.py control --device <device_id> --action on --attribute lock \
    --confirm "unlock the front door Aqara lock" --region us

# Plug/switch toggles and AC changes are MEDIUM: --confirm on first use per
# device, then proceed:
bin/aqara.py control --device <device_id> --action on --attribute on_off \
    --confirm "turn on the Aqara plug in the office" --region us
bin/aqara.py control --device <device_id> --action set --attribute ac_mode \
    --value '"cool"' --confirm "set the bedroom AC to cool" --region us

The rest: https://github.com/Anil-matcha/awesome-muse-connectors/blob/HEAD/connectors/aqara/SKILL.md