Skip to content

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 

Repository files navigation

Health Connect Get it on Google Play

Health Data Export

Description

Export your Health Connect data to Google Sheets or CSV. And because it pull data directly from Health Connect, it is compatible most health and fitness apps (Strava, Garmin, Fitbit, Coros, Samsung, Polar, Withings, Zepp/Amazfit, etc.). Choose which health metrics to include. Flexibility to select a date range. Supports the following data types

app-diagram
Activity
  • Active calories burned
  • Distance
  • Elevation gained
  • Exercise sessions
  • Floors climbed
  • Power
  • Speed
  • Steps
  • Total calories burned
  • VO2 max
  • Wheelchair pushes
Body measurements
  • Body fat %
  • Bone mass
  • Height
  • Lean body mass
  • Weight
Cycle tracking
  • Cervical mucus
  • Menstruation
  • Ovulation test
  • Sexual activity
Sleep
  • Sleep sessions (light, deep, REM sleep & awake)
Vitals
  • Blood glucose
  • Blood pressure
  • Body temperature
  • Heart rate (min/max/avg)
  • Heart rate variability (min/max/avg)
  • Oxygen saturation (min/max/avg)
  • Respiratory rate (min/ax/avg)
  • Resting heart rate

App Information

Android 9+ Screenshot_20260220-223508 Screenshot_20260220-223517 Screenshot_20260220-223536 Screenshot_20260220-223545 Screenshots_2026-02-20-22-37-21

Download & Install (Android only)

Get it on Google Play

Create a Google Spreadsheet + Get the Sheet ID

1) Create a new spreadsheet

  1. Open Google Sheets: https://sheets.google.com
  2. Click Blank (or create a new spreadsheet in Google Drive)
  3. Name it (example: Health Export)

2) Get the Spreadsheet ID

  1. Open the spreadsheet in a browser
  2. Copy the ID from the URL:

Example URL:

https://docs.google.com/spreadsheets/d/1AbCDefGhIJkLmNoPqrStuVwxYZ1234567890/edit#gid=0

Spreadsheet ID is the part between /d/ and /edit:

1AbCDefGhIJkLmNoPqrStuVwxYZ1234567890
  1. Paste this into the app’s Google Sheet ID field

Authorize Google Sign-In (Google Sheets access)

1) Connect your Google account

  1. In the app, tap Connect Google Account
  2. Choose the Google account you want to use

2) Approve permissions

During sign-in you’ll see a consent prompt asking to allow access to Google Sheets.

✅ Tap Allow to grant access so the app can write into your spreadsheet.

⚠️ If you don’t approve, exports to Google Sheets will fail.


Authorize Health Connect (read permissions)

1) Install/Update Health Connect

  • Make sure Health Connect is installed and set up on your phone (some Android versions integrate it into Settings).
  • Health Connect is available on Play Store for older versions of Android

2) Grant permissions

When prompted (or if you denied earlier):

  1. Open Health Connect
  2. Settings > Apps > App info > Health Data Export > Open
  3. Go to App permissions
  4. Find this app
  5. Allow read permissions for the data you want to export (Steps, Sleep, Heart Rate, etc.)

✅ Without permission, that data type will export as empty.


High-volume data warnings (important)

Some metrics generate a lot of records and can:

  • take much longer,
  • drain battery,
  • trigger Health Connect rate limits,
  • produce very large CSV files.

⚠️ High-volume examples:

  • Heart rate (min/max/avg)
  • HRV (min/max/avg)
  • Oxygen saturation (min/max/avg)
  • Respiratory rate (min/max/avg)

Recommendation: For large date ranges (especially All time), enable these only if you really need them.


Safer Export Mode (slower but more reliable)

The Safer export mode toggle is designed to reduce rate-limit errors by exporting more slowly.

When enabled, the app will:

  • ⏳ use larger time chunks
  • 🐢 add a 2-second delay between chunks
  • 📄 tune page sizes to reduce request bursts

✅ Use this if you frequently see:

“Rate limited request quota has been exceeded…”

⏱️ Expect exports to take longer—this is normal.


Recommended workflow (best practice)

✅ Preferred approach: Bulk CSV first, then Auto Export for ongoing updates

This avoids Google Sheets API limits and is usually faster for large history exports.

Step 1: Export bulk history to CSV

  1. Select your data categories + metrics
  2. Choose a large date range (e.g., All time)
  3. Tap Export CSV to Downloads
  4. The CSV file(s) will be saved to your phone’s Downloads folder

Step 2: Import CSV into Google Sheets (bulk load)

Options:

  • Upload CSV to Google Drive → open with Google Sheets
  • Or import from within Google Sheets (File → Import)

✅ This is the best way to load large historical datasets.

Step 3: Use “Export to Google Sheets” for incremental updates

After the bulk import:

  1. Use a smaller date range (e.g., last 7/30 days)
  2. Tap Export to Google Sheets
  3. Repeat as needed

Step 4: Enable Auto Export for ongoing sync

  1. Enable Auto Export
  2. Choose a frequency (e.g., every 12 or 24 hours)
  3. Keep date range reasonable (e.g., 7 days. Small ranges recommended)

Tips & Troubleshooting

“Only Vitals exported”

  • Ensure you enabled at least one metric under each category (e.g., Steps for Activity, Sleep Sessions for Sleep, Weight for Body).

Rate limit errors

  • Turn on Safer export mode
  • Reduce date range
  • Disable high-volume metrics
  • Try again later (quota replenishes over time)

About

Export your all Health Connect data directly to Google Sheets or CSV (no third‑party API) . Select date ranges and metrics such as Activity, Body Measurements, Sleep, Nutrition, Cycle Tracking, and Vitals.

Topics

Resources

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors