Microsoft family safety integration

[BBE-FR]

Describe the integration you'd like

The idea was brough by the new availability of Nintendo parental control in 2025.11.

In the same way the nintendo parental control has been implemented, if it was possible to have same kind of information from the Microsoft family safety application that would allow a unified management of all the screen time of our children.

What are your use cases for this integration?

Concatenation of all screen time into HA instead of having different parental controls:

• nintendo parental control (available in 2025.11)
• google family link (see associated FR )
• microsoft family safety
• any other parental control app...

Is there a public API or documentation?

I found the following archive in Github: https://github.com/pantherale0/ha-familysafety

Anything else?

Following discussion in forum:
https://community.home-assistant.io/t/integration-for-unified-parental-control-systems/564170

[pantherale0]

I wanted to bring Family Safety to HA a while back. But there are a number of unresolved issues that I cannot fix without someone else willing to reverse engineer the mobile app to identify the correct payloads.

[tr4nt0r]

@pantherale0 Do you mean this app?

I have it set up in an android emulator configured with mitm, so I could capture the requests. You could extend the library that is now used in the Xbox integration if you want, help is very welcome. https://github.com/tr4nt0r/python-xbox

[pantherale0]

@tr4nt0r that's the new one for Xbox only, the Family Safety one is different.

But that being said, I'd happily help extend the functionality of that lib, I just need some time to understand how the existing auth works.

[tr4nt0r]

I don't think you need to care about auth, it is the same as for all other API endpoints that the library supports, that part is already done ^^

[noiwid]

✅ Microsoft Family Safety Integration Available

For those interested in Microsoft Family Safety, I've created a working integration that's now available!

Repository: https://github.com/noiwid/HAFamilySafety

Features:

• 📊 Daily screen time tracking per child account
• 📱 Per-device monitoring and control
• 🔒 Remote lock/unlock devices
• 📲 Application tracking
• 💰 Account balance monitoring
• ⚙️ Services for device control and request management

Installation:

• Available via HACS (custom repository)
• Supports Home Assistant 2024.1.0+
• Full documentation included

Built using the pyfamilysafety library.

Hope this helps others looking for Microsoft Family Safety integration! 🎉

[pantherale0]

Are you sure this actually works? Just looking through it, this integration doesn't actually interact with pyfamilysafety correctly...

The function called here:

https://github.com/noiwid/HAFamilySafety/blob/1b7042b90e23f438e57eb3d2c59fd7aaa1cd57dc/custom_components/microsoft_family_safety/coordinator.py#L202

Does not accept such parameter.

https://github.com/pantherale0/pyfamilysafety/blob/9f7c49f0f362d80cd86c585ef1c719455b2b24f5/pyfamilysafety/account.py#L154

If I were to take a stab, this looks like it has been written by AI.

[lepeno82]

Hi,I install it, I was able to connect to my account, I recover the time on screen, but there is mistake on units ( time is in microseconds instead of minutes), and not able from HA to change any parameter ( bloc a device or change allowed time on screen)
Not fully working but partially

[noiwid]

Hi,
i've just published a massive update that now works properly and allow to manage almost all settings available in Family Safety.

Check release v1.0.0, any feedback are welcomed!

[noiwid]

hi, thanks for your feedback. A fix is on the way! Should be updated in couple of hours. Le dim. 9 nov. 2025, 16:48, lepeno82 ***@***.***> a écrit :

…

Hi,I install it, I was able to connect to my account, I recover the time on screen, but there is mistake on units ( time is in microseconds instead of minutes), and not able from HA to change any parameter ( bloc a device or change allowed time on screen) Not fully working but partially — Reply to this email directly, view it on GitHub <#1611 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AFML5A4YM3T32HKBBEWL2J3335O5BAVCNFSM6AAAAACLOF7BW2VHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTIOJRGYYDQNY> . You are receiving this because you are subscribed to this thread.Message ID: <home-assistant/feature-requests/repo-discussions/1611/comments/14916087@ github.com>

[noiwid]

Update: Integration is Read-Only (v0.6.0)

Quick update after testing and feedback from @pantherale0 (thanks for the pyfamilysafety library!).

What works: Screen time monitoring, device tracking, account info - all read-only features work perfectly.

What doesn't work: Device control (blocking/unblocking).

Technical details on what I tried:

• Using override_target.update_schedule() with various payloads (UNTIL, CANCEL, different durations)
• API consistently returns HTTP 201 (accepted)
• State changes in Home Assistant
• BUT: Physical devices never actually block/unblock
• Same issue with platform blocking via account.override_platform()

The API accepts everything we throw at it, but nothing happens on the actual devices. This suggests either:

1. Microsoft disabled these endpoints server-side
2. The mobile app uses different (undiscovered) endpoints
3. Additional authentication/validation we're missing

Question for the community: Does the "Lock device" button in the official Microsoft Family Safety mobile app
still work for you? We suspect Microsoft may have disabled this feature entirely, which would explain why the API
doesn't work either.

Current status (v0.6.0): Removed all control features. The integration now focuses on read-only monitoring
only - still useful for unified parental control dashboards. Release available
here.

Yes, I used Claude Code to help develop this, which led to some initial incorrect assumptions. After extensive
testing, confirming what @pantherale0 suspected: control simply doesn't work with the current API.

For contributors: Making device control work requires reverse engineering the Microsoft Family Safety mobile
app (network traffic analysis with mitmproxy/Burp Suite). Repo: https://github.com/noiwid/HAFamilySafety

@pantherale0 - any ideas on what might be missing? 🤔

[pantherale0]

The biggest problem is that the app actually has hidden all of the Xbox features, but that being said, Xbox Family, and even the web version follows the same schema, so it will take a bit more than just sticking a proxy in the middle.

By the way, the library already handles token refreshes. You cannot use a custom OAuth implementation as the required scopes are restricted by Microsoft (in the same way Google restricts access to the family link scopes.)

[pantherale0]

I've not tested it, but try this branch:

https://github.com/pantherale0/pyfamilysafety/tree/pantherale0-patch-1

The override target for desktop devices has been changed from DESKTOP to WINDOWS and mobile has been removed because I can't see any references to that in the app (apart from what is in the API responses).

A 201 status code is what is expected. Individual devices cannot be blocked, you can only block a whole platform (xbox, windows or mobile).

The same with setting the screen time (which was originally a "hidden" feature of the Nintendo API, until they actually updated the app so you could officially set the screen time to 0). you cannot set a per-device screen time, its either the whole platform, or not at all.

[noiwid]

Hi,
i've just published a massive update that now works properly and allow to manage almost all settings available in Family Safety.

Check release v1.0.0, any feedback are welcomed!