🌐 healthassistantlink.com • 📱 App Store • 📚 User Stories
Tip
A brand-new companion app that brings Apple Screen Time into your smart home. Block apps and app groups, set daily usage limits, and apply temporary allow/block overrides — all from Home Assistant, with usage and more surfaced as sensors.
✨ Uses the same Health Bridge integration — just pick Phone Assistant Link during setup. 📱 App Store — Download Now.
Health Bridge is a custom integration for Home Assistant that connects with the companion iOS apps Health Assistant Link (Apple Health → Home Assistant) and the new Phone Assistant Link (Apple Screen Time → Home Assistant) to bring your iPhone data into your smart home.
🆓 Free to use. Health Assistant Link is free to download and use to sync your Apple Health data into Home Assistant. An optional paid upgrade unlocks automated syncing, so your data keeps updating in the background without manual taps.
For the most reliable syncing:
- Keep both the Health Assistant Link iPhone app and the Apple Watch app open in the background.
- Use Shortcuts to schedule automatic syncs at 8:00 AM, 4:00 PM, and 12:00 AM.
- Aim to open the app at least once per day (this can be easily done as part of a "sleep mode" shortcut).
- Add one of the lock screen widgets
This setup creates optimal conditions for consistent, regular syncing of your Apple Health data to Home Assistant.
💡 Want ideas? See how others use their data in our User Stories.
You’ll need the companion iOS app installed on your iPhone:
👉 Download Health Assistant Link on the App Store
The app is free to use. Automated syncing is available as an optional paid upgrade.
This integration is available in HACS. You must have HACS set up in your Home Assistant instance first.
Once HACS is installed, add Health Bridge using the repository link below:
-
Install the Health Bridge integration from HACS.
-
Add the repository in HACS.
-
Download the integration.
-
Restart Home Assistant.
-
In the Integrations menu, click Add Entry, select if you're setting up Health Assistant Link or Phone Assistant Link, enter a secret token, and submit.
- Open the Health Assistant Link app.
👉 Download here if not already installed.
-
Accept all required permissions.
-
Enter your Home Assistant external URL, your name, and the secret token you created earlier.
-
Test the connection to confirm the URL is correct.
-
(Optional) Upgrade for automated syncing. The app is free to use with manual syncing. If you’d like your data to sync automatically in the background, subscribe to the optional automated syncing upgrade.
-
Tap Sync Now to start syncing. Leaving the app open in the background improves reliability.
Phone Assistant Link is a separate companion app that uses the same Health Bridge integration to bring Apple Screen Time controls into Home Assistant. Instead of health data, it exposes app-restriction and usage entities you can automate.
What you can do from Home Assistant:
- 🔒 Block apps & app groups — flip a switch to shield selected apps.
- ⏳ Daily usage limits — set a per-group allowance; the app auto-blocks when it's reached.
- ⏱️ Temporary overrides — apply a timed allow/block that expires on its own.
- 📊 Usage sensors — approximate, privacy-preserving screen-time minutes per app/group.
- 🚫 Blocked-opens sensors — an approximate daily count of how often a blocked app was opened (resets daily).
Setup: identical to the steps above — install Health Bridge via HACS, add an entry and choose Phone Assistant Link in step 5, then enter your Home Assistant URL and secret token in the app.
ℹ️ Privacy note: Screen Time metrics are approximate by design. Apple's on-device APIs keep app identities private and don't expose exact open counts, so usage minutes and blocked-opens are best read as trends rather than precise figures.
📱 Phone Assistant Link — App Store coming soon.
- 🌐 Website: healthassistantlink.com
- 📱 Health Assistant Link App
- 🛠 HACS Integration: Health Bridge
- 📚 User Stories & guides
- 💬 Join the Home Assistant community for troubleshooting and discussion.
- 📊 Check out this Dashboard card by BrainDeLook: https://github.com/BrainDeLook/health-bridge-dashboard-card
This project is licensed under the MIT License.