Hello everyone! 
I’m excited to introduce my Google Family Link integration for Home Assistant.
Acknowledgments
First and foremost, I want to thank:
- @tducret for his original Python package that documented the first Google Family Link API endpoints
- @Vortitron for his initial work on HAFamilyLink which served as the foundation for this project
- The Home Assistant community for the inspiration and numerous integration examples
Without these building blocks, this project would never have seen the light of day.
What is it?
This integration allows you to monitor and control your children’s Google Family Link devices directly from Home Assistant. Screen time, remote locking, usage statistics… everything is now accessible and automatable!
Key Features
Device Control
- Remote lock/unlock via switches
- Bidirectional synchronization: changes made in the Family Link app are reflected in Home Assistant
- Multi-device support: manage all your children’s supervised devices
Screen Time Tracking
- Real-time daily screen time
- Top 10 most used apps with detailed statistics
- Breakdown by application (hours, minutes, seconds)
- Automatic updates every 5 minutes (customizable)
App Management
- Number of installed apps
- Blocked apps with complete list
- Apps with time limits
- Complete details: package names, titles, configured limits
Child Information
- Complete profile: name, email, date of birth, age range
- Device information: model, name, capabilities, last activity
- Family members with their roles
Architecture: Add-on + Integration
The project consists of two complementary components:
1. Authentication Add-on (required)
Provides secure browser-based authentication:
- Browser automation with Playwright and headless Chromium
- 2FA support (SMS, authenticator, push notifications)
- Encrypted cookie storage
- Automatic session refresh
2. Home Assistant Integration
Ensures monitoring and control:
- User-friendly configuration interface (config flow)
- API client to communicate with Google Family Link
- Data coordinator with cache
- Entities (sensors and switches)
Why two components? Home Assistant’s Docker environment restricts browser automation. The add-on runs in a separate container with Chromium and Playwright, while the integration handles data retrieval and device control.
Automation Examples
Bedtime Lock
automation:
- alias: "Lock phone at bedtime"
trigger:
- platform: time
at: "21:00:00"
condition:
- condition: time
weekday: [mon, tue, wed, thu, fri]
action:
- service: switch.turn_off
target:
entity_id: switch.child_phone
Excessive Screen Time Alert
automation:
- alias: "Alert if excessive screen time"
trigger:
- platform: numeric_state
entity_id: sensor.family_link_daily_screen_time
above: 180 # 3 hours in minutes
action:
- service: notify.mobile_app
data:
message: "⚠️ More than 3 hours of screen time today!"
Automatic Weekend Unlock
automation:
- alias: "Unlock on weekend mornings"
trigger:
- platform: time
at: "09:00:00"
condition:
- condition: time
weekday: [sat, sun]
action:
- service: switch.turn_on
target:
entity_id: switch.child_phone
Installation
Via HACS (recommended)
- Add this repository as a custom source in HACS
- Install the Family Link Auth add-on from the Supervisor Store
- Start the add-on and authenticate via the web interface (port 8099)
- Install the Google Family Link integration via HACS
- Configure the integration in Settings → Devices & Services
Detailed installation guide available in the README.
Important Warning
This integration uses unofficial Google Family Link API endpoints obtained through reverse engineering.
Use at your own risk. This may violate Google’s Terms of Service and could result in account suspension. This project is not affiliated with, endorsed by, or connected to Google LLC.
Useful Links
- GitHub: GitHub - noiwid/HAFamilyLink
- Report a bug: GitHub · Where software is built
- Feature request: https://github.com/noiwid/HAFamilyLink/issues/new
- Discussions: https://github.com/noiwid/HAFamilyLink/discussions
Current Version
v0.5.0 - Real-time synchronization of device lock status
Contributions
Contributions are welcome! Feel free to:
- Report bugs
- Suggest new features
- Submit pull requests
- Share your automations
I hope this integration will be useful to you! Don’t hesitate to share your feedback, suggestions, or questions.
Happy parental control to all! 
