⚠️ Important Notice - Read-Only Integration
This release provides monitoring capabilities only. Device control features have been removed.
What Works ✅
- Screen time monitoring - Track daily usage and averages for each child account
- Device tracking - Monitor all registered devices and their usage
- Account information - Access profile data, balance, and application lists
- Family Link-style attributes - Detailed time formatting (hours, minutes, seconds, formatted_time)
What Doesn't Work ❌
Remote device control (blocking/unblocking) is not functional and has been removed from this release.
While the Microsoft Family Safety API accepts control commands (HTTP 201), devices do not actually block or
unblock. This appears to be a limitation on Microsoft's side, as even their official mobile app's "Lock device"
button no longer works reliably.
Why This Limitation?
This integration relies on an unofficial, undocumented API discovered through reverse engineering. Microsoft
provides no public API for Family Safety, and the control endpoints appear to be disabled or non-functional.
The original ha-familysafety integration by pantherale0 was
archived in October 2025, likely facing the same limitations.
What's New in v0.6.0
- Code refactoring - Improved maintainability with base classes and helper functions
- Bug fix - Screen time values now correctly display in seconds (was showing milliseconds)
- Enhanced attributes - Added
formatted_time,hours,minutes,secondsto all screen time sensors - Better documentation - Clear explanation of what works and what doesn't
- Cleaner codebase - Removed non-functional control features (switches, number entities, services)
For Contributors 🤝
We're actively seeking help to:
- Reverse engineer working device control endpoints through network traffic analysis
- Document the complete Microsoft Family Safety API
- Improve authentication (automatic token refresh, OAuth2 support)
See CONTRIBUTING.md for details.