Betterness
How it worksBett-iTutorialsAboutFor businesses ↗, opens Betterness One in a new tabLog inSign up
How it worksBett-iTutorialsAboutFor businesses: Betterness One ↗, opens Betterness One in a new tab
Log inSign up
Skip to content

Overview

  • What is Betterness

Connect

  • Connect by signing in
  • Claude custom connector
  • ChatGPT custom MCP server
  • Permissions
  • Connected apps
  • Privacy and data

Trust

  • Trust Center
  • Audit Trail
  • Limits & Scopes

Resources

  • Troubleshooting
  • Glossary

Server

Get started

  • Connect with an API Key
  • Authentication
  • First Tool Call

Clients

  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • ChatGPT
  • OpenClaw / BetterClaw

Recipes

  • Health Overview
  • Order Labs
  • Upload Lab Results
  • Biomarker Gap Analysis
  • Connect Wearables
  • Health Profile

Tools

  • All Tools
  • Profile
  • Wearables
  • Health Data
  • Nutrition
  • Logging
  • Biomarkers
  • Documents
  • Lab Tests
  • Lab Records
  • Lab Orders
  • Lab Results
  • Purchases
  • Confirming Actions
  • Inbox
  • Training Program
  • Updates
  • Health Profile
Docs/Betterness/Tools/Health Data

Health Data Tools

Pull measured data from connected wearables.


Common parameters

All tools below take:

ParameterRequiredFormat
fromyesYYYY-MM-DD
toyesYYYY-MM-DD
zoneIdno, defaults to UTCIANA timezone (e.g. America/New_York)

Always pass zoneId — daily aggregations align with that timezone's day boundaries. UTC default rarely matches the user's day.

Use 7-30 day ranges. Very large ranges return a lot of data.

getActivityData

Daily activity and workouts from Apple Health, Strava, Garmin, Peloton, Wahoo. Includes steps, distance, active + basal calories, floors climbed, VO2 max, and workout sessions (running, cycling, yoga, weightlifting, swimming, hiking, etc.) with duration and details.

Extra parameter: activityTypes (optional) — comma-separated filter (e.g. "RUNNING,YOGA").

Returns: JSON with daily activity and workout sessions, attributed to the best available source.

getVitals

Vital sign measurements from Apple Health, Oura, Garmin, Withings. Includes heart rate, HRV, blood pressure (systolic/diastolic), SpO2, glucose, and respiratory rate per day.

Returns: JSON with daily vitals, attributed to source.

getSleepData

Nightly sleep summaries from Apple Health, Oura, Eight Sleep, Garmin. Includes time in bed, total time asleep, and breakdown by sleep stage (deep, light/core, REM, awake) per night.

Use this for sleep duration, sleep quality, or general sleep trends. For cycle-level detail, use getSleepStages.

getSleepStages

Minute-by-minute sleep stage transitions from Apple Health, Oura, Eight Sleep, Garmin. Each entry: stage name (Deep, Core, REM, Awake), start, end, duration. Grouped by night.

More granular than getSleepData. Use it when the user wants cycle-level analysis.

getBodyComposition

Body composition from Apple Health, Withings, Garmin. Includes weight, body fat %, body water %, muscle mass %, bone mass %, visceral fat index, BMI, lean body mass, waist circumference per day.

If a tool returns empty

  • Verify with listConnectedDevices that a relevant provider is connected
  • Some metrics need specific devices (HRV: Oura/Apple Watch; glucose: a CGM)
  • Sync delays — most providers backfill within minutes, some up to a few hours
PreviousWearablesNextNutrition
Betterness

Product

  • How it works
  • Bett-i
  • Connect your AI

Resources

  • Tutorials
  • Podcast

Company

  • About
  • News
  • Contact

Legal

  • Privacy
  • Terms
  • Health data
  • Delete your account

For businesses

  • Betterness One ↗, opens Betterness One in a new tab

News from Betterness: the Friday Letter, launches and stories, by email.

  • Instagram ↗, opens in a new tab
  • X ↗, opens in a new tab
  • YouTube ↗, opens in a new tab
  • LinkedIn ↗, opens in a new tab
Download on the App StoreGet it on Google Play
HIPAA, powered by Vanta

HIPAA compliance monitored by Vanta.

Betterness, Inc. · Betterness gives health information, not medical advice.