Work in Progress These docs are a work in progress. More content is coming soon.

← Back to Documentation

My Google Health Data (Beta)

Access sleep, exercise, recovery, and Fitbit tracker metrics through Google's Health API.

Tool Reference: 16 tools with full schemas →

Setup

Connect the My Google Health Data beta toolkit to your Google account to allow your AI assistant to access Fitbit tracker data through Google’s Health API.

Prerequisites

Before connecting your Google Health data, ensure you have:

  • Configured an MCP server in your toolforest.io dashboard.
  • A Google account with supported Fitbit or Google Health data available.

Setup Steps

This is a new beta toolkit. While Toolforest is still in Google’s review process for this integration, access is allowlisted. Start by registering your email for the toolkit; after approval, the button will change from Register to Connect.

Step 1: Register for Access

  1. Open Toolforest and go to Toolkits.
  2. Select the Fitness tab.
  3. Find My Google Health Data (Beta).
  4. Click Register. This button appears where the Connect button normally appears.
  5. Confirm the registration request.
Registration Approval
Registration may be approved instantly or may take some time while the Google Health integration is in review. Check back later; once approved, the button will change from Register to Connect.

Step 2: Connect Your Google Health Data

  1. Once your registration is approved, click Connect.
  2. Choose the Google account with the health data you want this toolkit to use.
  3. You’ll be redirected to Google’s authorization page.

Important: The Google account you connect doesn’t need to match your toolforest.io email address.

Step 3: Authorize Permissions

Google will ask you to grant toolforest.io access to health and fitness data required by the toolkit. The beta currently focuses on Fitbit tracker data exposed through Google’s Health API, including sleep, exercise, HRV, breathing rate, skin temperature variation, and related daily metrics.

Click Continue to grant these permissions.

Step 4: Confirmation

After authorizing, you’ll be redirected back to toolforest.io with a “Successful connection” message. The toolkit status will now show Connected, and you can begin querying your data immediately.

Understanding Permissions

What toolforest.io Can Access

toolforest.io requests read-only access to your health metrics to enable features such as:

  • Permissions and Devices: View granted OAuth scopes and list paired devices visible to the connected account.
  • Daily Metrics: Retrieve sleep, activity, exercise, and recovery-related daily summaries with optional baseline calculations.
  • Sleep and Recovery: Analyze sleep architecture, overnight HRV, breathing rate, skin temperature variation, and resting heart rate.
  • Workout Sessions: Fetch exercise sessions with type, duration, zones, calories, and pagination controls.
  • Trends and Anomalies: Compute rolling trends, percent changes, and coaching-safe anomaly flags across supported metrics.

Data Source Selection

Several tools support a data_source_family option. Use the default behavior unless you specifically want to target a source family such as Google wearables, all sources, or Google first-party sources.

Data Privacy

Your health data is retrieved only when you explicitly ask your LLM to query it. toolforest.io does not store your historical health data permanently; it acts as a bridge to fetch the specific information your assistant needs to answer your questions.

Managing Your Connection

Disconnect

To disconnect the toolkit:

  1. Click Manage accounts next to the toolkit.
  2. Click Disconnect for the Google account you want to remove.
  3. toolforest.io will remove the stored access tokens for the disconnected account.
Note
Disconnecting removes toolforest.io's access tokens but does not automatically revoke permissions in your Google account. The toolkit will require reauthorization to connect again.

Revoke Permissions

To fully revoke toolforest.io’s access to your Google account:


Capabilities

CategoryCapabilities
PermissionsView granted Fitbit/Google Health OAuth scopes and understand which data types and access levels are available
DevicesList Google Health paired devices visible to the connected account
Daily SummariesRetrieve date-range aggregates for supported Fitbit metrics, with optional personal baselines
Workout SessionsFetch exercise sessions with activity type, duration, heart-rate zones, calories, sorting, filtering, and pagination
Sleep DetailRead per-night sleep architecture, including stages, onset, WASO, short wakes, naps, and manually entered logs when requested
Recovery SignalsFetch overnight HRV, breathing rate, skin temperature variation, resting heart rate, and fused sleep-health panels with computed flags
TrendsCompute rolling statistics and percent change for supported metrics over configurable windows
Anomaly DetectionDetect unusual metric values against rolling baselines with configurable sensitivity and consecutive-day thresholds