Note: AI tools were used as assistance during development and documentation.
Hello everyone! 
I’m excited to introduce my Google Family Link integration for Home Assistant - monitor and control your children’s screen time, devices, schedules and location, directly from HA.
Example dashboard built entirely from the integration - the YAML + setup notes are in the examples/ folder.
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
- All the contributors and issue reporters who have helped harden the integration release after release
Without these building blocks, this project would never have seen the light of day.
What is it?
This integration lets you monitor and control your children’s Google Family Link devices directly from Home Assistant. Screen time, remote locking, bedtime & school schedules, time bonuses, app blocking, GPS location… everything is now accessible and automatable!
Multi-child and multi-device are first-class - manage all your kids and all their supervised devices from one place.
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
- Ring a device to help locate it
Time Management
- Bedtime control - enable/disable and edit the start/end times (weekly schedule or “today only”)
- School time control - enable/disable restrictions
- Daily limits - enable/disable and set the daily screen-time quota per device
- Time bonuses - grant +15 / +30 / +60 min, or cancel an active bonus
Screen Time Tracking
- Real-time daily screen time
- Screen time remaining per device (accounts for bonuses and used 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
- Per-app daily limits - including “unlimited time” and “block” states
- Complete details: package names, titles, configured limits
GPS Location (optional, opt-in)
- Track your child’s location via a
device_trackerentity - Saved-place detection (Home, School…), full address, source device, battery level
- On-demand location refresh
- Disabled by default - privacy first
(each poll may notify the child’s device)
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
- Web-based access via noVNC (no separate VNC client needed)
- 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 caching + graceful degradation on transient API errors
- Entities (sensors, binary sensors, switches, buttons, device tracker)
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. (A standalone Docker image is also available if you don’t run HA OS/Supervised.)
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.child_daily_screen_time
above: 180 # 3 hours in minutes
action:
- service: notify.mobile_app
data:
message: "⚠️ More than 3 hours of screen time today!"
Grant a Time Bonus from an Automation
automation:
- alias: "Homework done → +30 min"
trigger:
- platform: state
entity_id: input_boolean.homework_done
to: "on"
action:
- service: familylink.add_time_bonus
data:
entity_id: switch.child_phone
minutes: 30
Example Dashboard
A ready-to-use, Family-Link-only Lovelace dashboard (screen time, per-device limits, bedtime/school time, bonuses, top apps) is included in the repo - with the screenshot above, the YAML, and the list of required HACS cards:
HAFamilyLink/examples at main · noiwid/HAFamilyLink · GitHub
Just copy the YAML and rename the placeholder entity IDs to match yours.
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.
familylink) right after triggering an action - a401/Session expiredmeans you need to re-authenticate in the add-on.
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: Control your children's Android devices through Google Family Link directly from Home Assistant. Monitor screen time, set daily limits, manage bedtime and school schedules, and grant bonus time - all from your dashboard. · GitHub
- Report a bug: Issues · noiwid/HAFamilyLink · GitHub
- Feature request: Sign in to GitHub · GitHub
- Discussions: noiwid/HAFamilyLink · Discussions · GitHub
Current Version
v1.2.11 - GPS location fix (numeric LocationRefreshMode), removed bundled requirements that broke HA 2026.7, plus the new example dashboard. See the CHANGELOG for the full history (bedtime/school schedules, per-app limits, multi-child support, on-demand location, and much more since v0.5.0).
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! 
Lock / unlock devices with two-way synchronization (changes made in the Family Link app are reflected in Home Assistant).
Bedtime and 
School Time controls that let you enable or disable today's restrictions using your actual configured schedules.
Daily limits and time bonuses to manage screen time directly from Home Assistant.
Ring a device to help locate it, just like the app's "Play Sound" feature.
Highlights Since v1.1.1
Hebrew Translation
More Robust & Secure
