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

← Back to Documentation

My Fitbit Data

Access health and fitness data with daily summaries, intraday tracking, trend analysis, and anomaly detection.

Setup

Connect the My Fitbit Data toolkit to your Fitbit account to allow your AI assistant to access your health and fitness metrics.

Prerequisites

Before connecting your Fitbit account, ensure you have configured an MCP server in your toolforest.io dashboard.

Setup Steps

Step 1: Connect to Fitbit

  1. Navigate to your MCP server panel in the toolforest.io dashboard.
  2. Locate the My Fitbit Data toolkit.
  3. Click the Connect button.
  4. You will be automatically redirected to Fitbit’s authorization page.

Step 2: Authorize Permissions

You will be prompted to allow toolforest.io to access specific data points in your Fitbit account. For full toolkit functionality, ensure the following permissions are checked:

  • Activity and exercise
  • Heart rate
  • Oxygen saturation (SpO2)
  • Sleep

Click Allow to grant these permissions.

Step 3: Confirmation

After authorizing, you will 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:

  • Activity Data: Steps, calories burned, and active minutes.
  • Biometrics: Heart rate, resting heart rate, and SpO2 levels.
  • Sleep: Sleep duration, stages, and efficiency scores.

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 the Disconnect button in your MCP server panel.
  2. toolforest.io will remove the access tokens used to communicate with Fitbit.
🔒 Note
Disconnecting removes toolforest.io's access tokens but does not automatically revoke permissions in your Fitbit account settings.

Revoke Permissions

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


Capabilities

CategoryCapabilities
PermissionsView granted OAuth scopes, understand accessible data types
Daily SummariesSteps, calories, active minutes, resting HR, HRV, sleep (duration/efficiency/stages), SpO2
IntradayMinute/second-level data for heart rate, steps, calories; configurable granularity (1sec-15min)
TrendsRolling window stats (mean, std dev), percent change vs prior periods (window/week/month)
Anomaly DetectionZ-score analysis, configurable sensitivity, consecutive day tracking, human-readable explanations