Skip to content
Home Assistant TestFlight
Security & safety

Aqara Devices (G3, G2H Pro, G410, G4, M3, M100, M200, FP2, FP300, A100, A100 Pro, Xingyao, and U200)

Darkdragon14/ha-aqara-devices · vv1.5.1

HACSCloud push

Custom Home Assistant integration for Aqara devices. Supports G3, G2H Pro, G410, G4, M3, M100, FP2, FP300, and A100 Pro via Aqara Cloud with advanced controls, presence telemetry and extended features beyond the official integration.

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

EntityShows up asNote
switchSwitch or outlet
lockLockNeeds its own HomeKit Bridge in accessory mode
cameraCameraNeeds its own HomeKit Bridge in accessory mode
binary_sensorSensor (motion, contact, leak, smoke…)
sensorSensor (temperature, humidity, air quality…)
buttonButton (as a switch)
selectMode picker (as switches)

What people report

Cloud-based support for Aqara hubs, cameras, FP2/FP300 sensors and Matter-class locks; the maintainer adds new lock models quickly, with U300/U400 in beta.

  • Works13
  • Partly works2
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Aqara Camera Hub G2H ProWorks CloudDedicated support added in 2026-05
Saved copy
Summary - Add dedicated support for Aqara Hub M100, Camera Hub G2H Pro, and Doorbell G410 models. - Wire new device specs through setup, coordinators, bridge subscriptions, SSE updates, and HA entity platforms. - Extend G3 gesture handling with both-hands gestures and motion events. ## Verification - `python3 -m compileall custom_components/ha_aqara_devices` - Validated translation JSON files with Python `json.loads`

Excerpt saved from GitHub on 2026-10-23.

PR #50 · 2026-05
Aqara Door Lock A100Works CloudListed as supported
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara Door Lock A100 ProWorks CloudListed as supported
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara Doorbell G4Works CloudListed as supported
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara Doorbell G410Works CloudDedicated support added in 2026-05
Saved copy
Summary - Add dedicated support for Aqara Hub M100, Camera Hub G2H Pro, and Doorbell G410 models. - Wire new device specs through setup, coordinators, bridge subscriptions, SSE updates, and HA entity platforms. - Extend G3 gesture handling with both-hands gestures and motion events. ## Verification - `python3 -m compileall custom_components/ha_aqara_devices` - Validated translation JSON files with Python `json.loads`

Excerpt saved from GitHub on 2026-10-23.

PR #50 · 2026-05
Aqara FP2 presence sensorWorks CloudListed as supported
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara FP300 presence multi-sensorWorks CloudListed as supported
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara Hub G3Works CloudListed as supported
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara Hub M100Works CloudDedicated support added in 2026-05
Saved copy
Summary - Add dedicated support for Aqara Hub M100, Camera Hub G2H Pro, and Doorbell G410 models. - Wire new device specs through setup, coordinators, bridge subscriptions, SSE updates, and HA entity platforms. - Extend G3 gesture handling with both-hands gestures and motion events. ## Verification - `python3 -m compileall custom_components/ha_aqara_devices` - Validated translation JSON files with Python `json.loads`

Excerpt saved from GitHub on 2026-10-23.

PR #50 · 2026-05
Aqara Hub M3Works CloudListed as supported
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara Smart Lock U200Works CloudMatter lock; state, control and battery via cloud
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara Smart Lock U200 LiteWorks CloudModel aqara.matter.4447_10247 added to main after report
Saved copy
The integration currently supports the Aqara Smart Lock U200 (aqara.matter.4447_10242), but not the U200 Lite, which reports a different model string. Confirmed via Aqara developer console (Device management page): Device ID: matt.45af5c7f155e7f4ca2659000 Equipment Model: aqara.matter.4447_10247 Status: Online Device is authorized to my project and confirmed working (remote lock/unlock via the Aqara Home app), the M100 hub in the same account/project is correctly discovered by the integration, but the U200 Lite is not. Since the model string differs only in the last digit from the …

Excerpt saved from GitHub on 2026-10-23.

Issue #95 · 2026-09
Aqara Smart Video Door Lock XingyaoWorks CloudListed as supported (aqara.lock.acn002)
Saved copy
Supported devices: Hub G3; Camera Hub G2H Pro; Doorbell G410; Doorbell G4; Hub M3; Hub M100; Presence Sensor FP2; Presence Multi-Sensor FP300; Door Lock A100; Door Lock A100 Pro; Smart Lock U200; Smart Lock U200 Lite; Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀); Supported devices reference.

Excerpt saved from the README on 2026-10-23.

README
Aqara Smart Lock U300Partly works CloudExperimental beta build reuses U200 support; PR still open
Saved copy
Devices | Device | Model | Protocol | Notes | | --- | --- | --- | --- | | Aqara Smart Lock U400 | `aqara.matter.4447_10244` | Matter over Thread | front door (UWB / Apple Home Key) | | Aqara Smart Lock U300 | `aqara.matter.4447_10241` | Matter over Thread | second entry door | Both are Matter-class models and follow exactly the same naming pattern as the already-supported U200 (`aqara.matter.4447_10242`) and U200 Lite (`aqara.matter.4447_10247`). ### What the Aqara cloud already returns for them `query.device.info` (Aqara Open API v3) lists both locks in my account with an empty `parentDid` …

Excerpt saved from GitHub on 2026-10-23.

Issue #99 · 2026-10
Aqara Smart Lock U400Partly works CloudExperimental beta build reuses U200 support; PR still open
Saved copy
Summary - provide initial cloud entities for U300 and U400 using the existing U200 trait layout, preserving U200/Lite behavior - collect bounded, asynchronous capability metadata and expose downloadable diagnostics without identifiers, credentials, trait values or raw errors - keep missing experimental traits unknown and document the testing workflow and limitations - prepare `v1.6.0-beta-u300-u400.1` for hardware testing; unlock-method events and charging-state entities remain deferred Related to #99. This PR does not claim full event support or verified hardware/control compatibility. ## …

Excerpt saved from GitHub on 2026-10-23.

PR #100 · 2026-10

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Cloud push

Goes through the maker’s cloud, which sends updates as they happen. Needs the internet and an account.

Details

Installs (analytics)142 (0.02%)
GitHub stars60
Latest versionv1.5.1 (2026-10-02)
Set up in the UIYes
Maintainers@Darkdragon14
LicenseMIT

Devices listed in its README

  • Hub G3
  • Camera Hub G2H Pro
  • Doorbell G410
  • Doorbell G4
  • Hub M3
  • Hub M100
  • Presence Sensor FP2
  • Presence Multi-Sensor FP300
  • Door Lock A100
  • Door Lock A100 Pro
  • Smart Lock U200
  • Smart Lock U200 Lite
  • Smart Video Door Lock Xingyao (全自动智能猫眼门锁 星耀)
  • Supported devices reference

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.