Back to all devices

Aqara WS-K05E in Home Assistant

Wall switches · Zigbee · Dimmer Switch H2 US

Zigbee2MQTT Quirk proposed, not merged yet 1 open report

Zigbee device – see the note above on what ZHA needs for it.

Brand: Aqara
Model: WS-K05E
Device type: Wall switches
Radio: Zigbee
Reports itself as: lumi.switch.agl007
Zigbee2MQTT: Device page on zigbee2mqtt.io

How the device gets into Home Assistant

official ZHA – with a Zigbee coordinator and the ZHA integration; for all its functions it needs a custom quirk, see above.
official Aqara hub – paired with an Aqara hub that works as a Matter bridge (such as the M3 or M2), which shares supported devices with Home Assistant.
add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT. Source

Known problems and fixes

Requests for ZHA support

support requested Someone asked ZHA to support this device or one of its functions. since 8 de maio de 2026 · zha-device-handlers #4983

Changes proposed for ZHA

pull request A change to ZHA for this device has been proposed and is waiting for review. since 27 de agosto de 2026 · zha-device-handlers #5284

ZHA quirks for this device

Quirk proposed, not merged yet Recommended quirk

Proposed to ZHA and waiting for review – the maintainers check it before it becomes part of Home Assistant.

Adds: Operation mode (paddle) Operation mode (up button) Operation mode (down button) Mode switch Phase Power on state Minimum brightness Maximum brightness LED indicator Flip indicator light

Source: zha-device-handlers · pull request #5284 · by @e11o · 27 de agosto de 2026
Signature: Aqara / lumi.switch.agl007

1 more quirk for this device

Custom quirk shared in an issue Aqara / lumi.switch.agl007 zha-device-handlers · issue #4983 · by @explosivo2k2 · 8 de maio de 2026

The quirk is not part of ZHA yet. You can use it as a custom quirk until it is:

Tell ZHA where custom quirks are kept – in configuration.yaml:
```
zha:
  custom_quirks_path: /config/custom_zha_quirks/
```
Create that folder and save the quirk as a .py file in it.
Restart Home Assistant. If the device was paired before, reconfigure it or remove and pair it again so the quirk is applied.
Check it worked: the device page shows the quirk under Zigbee info.

A custom quirk has not been reviewed by the ZHA maintainers. Delete the file once the quirk is part of a Home Assistant release – otherwise the old copy takes precedence.

All quirks in the ZHA quirk database →