# Fitbit MCP for AI Agents AI Agent Connect

> Fitbit MCP. Connect your wearable data to your AI agent to query sleep patterns, heart rate trends, and nutrition logs in plain English. It turns your fitness history into a conversational health dashboard.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_dNWrgpBODs4GYmzoSN0iGYrdbpmornjlBNGi10BA/ai-agent-connect
- **Tags:** health-tracking, wearables, fitness, sleep-analysis, heart-rate

## Description

Imagine asking your AI what your sleep was like last night without digging through a messy app. This Connector bridges that gap by letting your agent read your Fitbit data directly. You can ask about your VO2 Max trends over the last month or see how much water you actually drank on Tuesday. Instead of scrolling through graphs, you just talk. It handles the heavy lifting of pulling your activity summaries, heart rate zones, and body weight logs so you can focus on what the numbers actually mean for your fitness goals. Since Vinkius hosts this, you can plug it into your existing workflow and get answers instantly. It's about moving from looking at data to knowing your health.

## Tools

### get_activities_date
Get a quick summary of steps, distance, and active minutes for a day. Use this for a fast daily recap of your movement.

### get_activities_timeseries
Retrieve granular data like floors climbed or elevation over long periods. This is perfect for spotting long term trends.

### get_body_weight
Fetch your weight, BMI, and fat percentage logs for a specific date. It helps you keep track of your physical progress.

### get_breathing_rate
Check your breathing rate in breaths per minute for SpO2-enabled devices. This provides a deeper look at your respiratory health.

### get_cardio_fitness_score
Get your VO2 Max values and percentile rankings for a specific date. This helps you track your aerobic endurance over time.

### get_devices
See all connected Fitbit devices including battery levels and sync status. Use this to manage your wearable hardware.

### get_spo2
Retrieve your average blood oxygen saturation levels for a specific day. This is a key metric for many wearable users.

### get_foods_date
Pull a summary of calories, macros, and water intake for any day. It works great for reviewing your daily nutrition.

### get_sleep_timeseries
View your sleep duration and sleep stage trends over several weeks. This helps you identify patterns in your rest quality.

### get_water
See your total water consumption in milliliters for any specific date. It makes checking your hydration goals much easier.

### get_heart_date
Review resting heart rate and heart rate zones for a specific day. This gives you a clear picture of your daily cardiac activity.

### get_heart_timeseries
Pull daily heart rate and zone data over a custom date range. Use this to see how your heart reacts to consistent training.

### get_profile
Fetch your display name, age, height, and other basic profile details. This helps the agent understand your basic stats.

### get_sleep_date
Get a detailed breakdown of sleep stages and efficiency for a specific night. It shows exactly how much time you spent in REM.

## Prompt Examples

**Prompt:** 
```
How was my sleep last night?
```

**Response:** 
```
### Sleep Summary
**Total Sleep:** 7h 23m
**Efficiency:** 82%

| Stage | Duration | % |
| :--- | :--- | :--- |
| Deep | 1h 45m | 24%
| Light | 3h 52m | 53%
| REM | 1h 20m | 18%
| Awake | 26m | 5%

*Note: Your sleep score was 82/100, which is slightly higher than your weekly average.*
```

**Prompt:** 
```
What's my heart rate trend for the last week?
```

**Response:** 
```
### Heart Rate Trends (Last 7 Days)
* **Avg Resting HR:** 62 bpm (Down from 65 bpm last week)
* **Peak Zone Time:** 45 minutes total
* **Cardio Fitness Score:** 42 (Good)

Your heart rate zones show you spent the most time in the **Fat Burn** and **Cardio** zones during your workouts.
```

**Prompt:** 
```
Did I hit my water goal yesterday?
```

**Response:** 
```
### Hydration Log
Yes, you reached your goal! 
* **Total Intake:** 2,400 ml
* **Log Entries:** 8 entries recorded throughout the day.

You stayed consistent with your hydration from morning until evening.
```

## Capabilities

### Track sleep stages
Get a breakdown of deep, light, and REM sleep for specific nights.

### Monitor heart rate zones
See how much time you spent in cardio or fat burn zones.

### Review nutrition logs
Check your daily calorie intake and water consumption.

### Analyze activity trends
View time series data for steps, distance, and active minutes.

### Check body composition
Pull your latest weight, BMI, and fat percentage entries.

## Use Cases

### The Sleep Audit
A user asks 'Why was I so tired today?' and the agent uses get_sleep_date to show poor REM sleep from the previous night.

### The Workout Review
A runner asks 'How was my heart rate during my run?' and the agent pulls data from get_heart_date to show their peak zones.

### The Nutrition Check
A dieter asks 'How much water did I drink yesterday?' and the agent pulls the get_water log for a quick answer.

### The Fitness Goal
A user asks 'Is my cardio fitness improving?' and the agent compares get_cardio_fitness_score from last month to today.

## Benefits

- Stop digging through apps to find your sleep score. Use get_sleep_date to get a breakdown of REM and deep sleep instantly.
- Monitor your fitness progress with get_cardio_fitness_score to see how your VO2 Max changes over months.
- Track your hydration habits more accurately by asking your agent for your get_water logs on any day.
- Get a clear view of your activity history using get_activities_timeseries to see trends in floors climbed and elevation.
- Manage your hardware easily by using get_devices to check battery life and sync status for all your wearables.

## How It Works

The bottom line is you get a conversational interface for your entire wearable health history.

1. Subscribe to the Fitbit MCP on Vinkius
2. Create an OAuth2 token in your Fitbit Developer Portal
3. Start asking your AI client for health summaries

## Frequently Asked Questions

**Can I see my sleep stages with the Fitbit MCP?**
Yes, you can see a full breakdown of your deep, light, and REM sleep stages for any specific night.

**Does the Fitbit MCP work with my old devices?**
Yes, the Connector can list all connected Fitbit devices to show you their status and sync history.

**Can I track my water intake using the Fitbit MCP?**
Yes, you can ask your agent to pull your water logs for any specific day to see your total consumption.

**How do I get my VO2 Max with the Fitbit MCP?**
You can ask your agent to retrieve your cardio fitness score and VO2 Max values for specific dates.

**Can I see my nutrition logs in the Fitbit MCP?**
Yes, you can query your food logs to see calories, macros, and water intake for any day.

**Can I query sleep data for a specific date range?**
Yes! Use the sleep time series tool to query sleep trends across any date range. You can also inspect a single night in detail with the sleep date tool, including all sleep stages.

**What health metrics can I access?**
You can access 14 different health metrics: activities, sleep (date & time series), heart rate (date & time series), SpO2, breathing rate, cardio fitness score, body weight, water intake, food logs, device info, and user profile.