Skip to content

Health Connect

Health Connect is Android's unified platform for health and fitness data. As of pull request #5346, Gadgetbridge can sync your device data to Health Connect, making it available to other health and fitness apps that support the platform.

From a privacy standpoint, all data stored in Health Connect stays inside the device, no data is sent to external servers (even to Google) through this integration. Applications must be explicitly permitted to access data stored in Health Connect, and given permissions can be revoked at any time through Android settings.

Usage of non-free (as-in freedom) software ahead

Health Connect is a component integrated to AOSP (Android Open Source Project), so it is a part of Android since Android 14 and later, therefore no any proprietary application is required to have Health Connect feature on your device if you use these versions of Android.

However, for earlier versions of Android (13 and below), since it wasn't a part of Android at that time, to have Health Connect feature on your system, you do need to install "Health Connect" application from Google Play Store which is proprietary.

Supported data types

Gadgetbridge can sync the following data types to Health Connect, as long as your gadget records them:

  • Steps
  • Distance
  • Active calories
  • Heart Rate
  • Blood Oxygen Saturation (SpO₂)
  • Blood Glucose
  • Blood Pressure
  • Heart Rate Variability (HRV)
  • Body / Skin Temperature
  • Respiratory rate
  • Resting heart rate
  • Sleep Sessions
  • Weight
  • VO₂ Max
  • Hydration
  • Exercise Sessions, as well as the following details:
    • Heart rate
    • Cadence (steps / pedaling) pull request #6959
    • Distance
    • Elevation Gained
    • Exercise Route
    • Power
    • Speed
    • Active Calories
    • Total Calories Burned

Setting up

In Gadgetbridge, go to " Settings → External Integrations → Health Connect".

  1. Enable Enable Health Connect Export and grant the permissions for the data types you want to sync.
  2. Under Devices, tap Select devices and choose the gadgets whose data should be shared with Health Connect.
  3. On first use, configure the initial sync, controlling how much historical data to sync.

To configure your sync preferences, under Synchronization:

  • Sync after device sync (off by default) syncs to Health Connect automatically after a selected gadget has finished syncing its activity data.
  • Detailed workout sync (on by default) includes GPS routes and per-second metrics (heart rate, speed, power) for workouts (takes longer to sync).

A sync can also be triggered from the Debug menu, in the Health Connect section, with "Trigger manual sync".

Initial sync

When you first enable Health Connect sync, you can choose how much historical data to sync:

  • Sync last: 3 days, 7 days or 30 days
  • Sync all available data from your gadgets
  • Sync from a custom date

Note that syncing large amounts of historical data may take some time and could trigger rate limits. The sync will automatically retry if rate limits are encountered.

Workouts

If a workout fails to sync to Health Connect, a Health Connect icon is shown on that workout in the workout list and in the header of its details. Tapping the icon in the details shows when and why the sync failed.

Deleting a workout in Gadgetbridge also removes it from Health Connect.

Disabling or resetting

To disable Health Connect Export, remove all permissions of Gadgetbridge from the Health Connect app (for example through Health Connect Settings).

When all permissions are revoked, Gadgetbridge asks whether you also removed the data from Health Connect. Choose Reset Sync History to re-sync all old data once you grant the permissions again, or Keep Sync History to only sync new data.