About
Aqara Devices (G3, G2H Pro, G410, G4, M3, M100, M200, FP2, FP300, A100, A100 Pro, Xingyao, and U200) connects Aqara cameras, hubs, sensors and locks. It uses Aqara Cloud with the Aqara Open API and a separate bridge that pushes live updates to Home Assistant, so it does not depend only on polling. It adds binary sensors, buttons, cameras, events, locks, numbers, selects, sensors and switches, including gesture and face detection, volume and ringtone controls, and door lock status. Camera live streams are optional and go through a separate go2rtc instance, with local HomeKit pairing for supported camera models. Setup happens in the UI, using Aqara developer credentials, a bridge address and a verification code sent by Aqara.
Automatic summary of the README and code of Darkdragon14/ha-aqara-devices. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Cameras
- Locks
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Aqara FP2
- Aqara account (email or phone)
- Region
- Bridge URL
- Bridge token
- App ID
- Key ID
- App key
Authorization Code
- Authorization code
After setup
- Authorization code
- Aqara account (email or phone)
- Region
- Bridge URL
- Bridge token
- App ID
- Key ID
- App key
- Camera
- Action
- go2rtc API URL
- API username
- API password
- Clear saved API credentials
- go2rtc RTSP URL
- Source
- Discovered camera
- HomeKit pairing code
- Stream
- Remove stream association
- Also unpair the camera from go2rtc
Texts from the code of Darkdragon14/ha-aqara-devices.
Entities
- Binary sensorsNight vision, Motion Event, Gesture V sign, Gesture Four, Gesture High Five, Gesture Finger Gun, Gesture OK, Gesture V sign both hands, Gesture Four both hands, Gesture High Five both hands, Gesture Finger Gun both hands, and 10 more
- ButtonsUp, Down, Left, Right, Ring Alarm Bell, Restart Device, Restart Coordinator, Set to No Presence
- CamerasLive stream
- EventsFace Recognition Event
- LocksLock
- NumbersVolume, System Volume, Alarm Volume, Doorbell Volume, Alarm Duration, Doorbell Duration, Music Volume, Alarm Clock Volume, Night Light Brightness, Arming Delay Time, Camera Volume, and 1 more
- SelectsGateway Language, Alarm Ringtone, Doorbell Ringtone, Screen Flip, Camera Mode, Work Mode, AC Mode
- SensorsGateway Time Zone, Night Light Configuration, Face Recognition Event, Stranger Face Event, Door Event, Door Lock Status, Open Door Method, Fingerprint User ID, Password User ID, NFC User ID, and 29 more
- SwitchesVideo, Detect Human, Detect Pet, Detect Gesture, Detect Face, Sub-device Deletion Protection, Sound Detection, Timed Sleep, Motion Push, Motion Detection, and 16 more
From the README
Aqara Devices (G3, G2H Pro, G410, G4, M3, M100, M200, FP2, FP300, A100, A100 Pro, Xingyao/ACN002 locks, and U200) connects supported Aqara cameras, doorbells, hubs, presence sensors, and locks to Home Assistant with Aqara Open API v3 and aqara-rocketmq-bridge.
Instead of relying only on periodic polling, the integration now uses Aqara Message Push -> RocketMQ -> bridge -> Server-Sent Events (SSE) so Home Assistant receives live updates while the integration keeps Aqara authentication, token refresh, and resource subscriptions in sync.
Shows in Vulpo
Quick Toggle card, Lock card, Camera card, Button card, Apple Watch, Control Center.Information
- Installs
- 140 sharing analytics
- GitHub stars
- 61
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v1.5.1,
- Category
- Sensors, Motion and presence
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
ha_aqara_devices- Issues
- Report an issue











