Aqara Button Bedside Lamp Control (Zigbee2MQTT – MQTT-based)

Blueprints Exchange
1

Hi everyone! :wave:

Here’s a simple but powerful MQTT-based blueprint that lets you control a dimmable light using a single Aqara Wireless Mini Switch (WXKG11LM) with Zigbee2MQTT.

:white_check_mark: What It Does

  • :radio_button: Single click → Toggle light on/off
  • :radio_button: Double click → Increase brightness by 10%
    :arrow_right_hook: If brightness ≥ 100%, it loops back to 10%
  • :radio_button: Long press → Toggle between low brightness (10%) and high brightness (80%)

:hammer_and_wrench: Requirements

  • Home Assistant
  • Zigbee2MQTT
  • An Aqara WXKG11LM button (or similar single-button device)
  • A dimmable light
  • MQTT integration enabled and working in HA

:inbox_tray: Import Blueprint

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.

:control_knobs: Inputs

  • MQTT Topic → e.g. zigbee2mqtt/button_remote_ishai_bedside
  • Target Light → Any dimmable light entity

:mag: How It Works

  • Brightness is calculated in percentages (converted to 0–255 scale)
  • Double click will go: 10% → 20% → 30% … → 100% → 10% → repeat
  • Long press toggles between 10% and 80% for quick mood changes

:bulb: Tips

  • Works great on bedside lamps or simple smart bulbs
  • Based entirely on MQTT topic and payload (no need for hidden entities)
  • Easily adaptable for other single-button Zigbee2MQTT remotes
2

Quick info: the link https://raw.githubusercontent.com/Ishai-Revach/ha-blueprints/refs/heads/main/blueprints/automation/Ishai/Light_Button.yaml does not work.