get_activity_goals
Get the raw JSON response for user's activity goals from Fitbit. Supports 'daily' and 'weekly' periods. Returns goal values for steps, distance, calories, floors, active minutes, and active zone minutes.
LABSCO SUMMARY
Every range limit is written on the tool, so you learn it before the call fails.
The API's ceilings are stated where you will actually read them: 100 days for a sleep range, one year for a heart-rate range, 1,095 days for nutrition and Active Zone Minutes, 30 days for the activity time series. It is a small thing that saves a lot of failed calls. Everything returns the raw JSON response, which is honest about what it is — no reshaping and no derived metrics — and it means an answer you get back is grounded in the fields Fitbit actually publishes. It reads only: nothing here logs a meal or changes a goal.
What it is
A read-only Fitbit server returning the raw API responses for weight, sleep, heart rate, activity, nutrition and goals, addressed either by a period ending today or by an explicit date range.
What you get
- Weight entries over a period such as 1d, 7d, 30d, 3m, 6m or 1y
- Sleep logs across a start and end date, with the API's 100-day maximum range stated on the tool
- Heart rate two ways: a period ending today or on a given date, and an explicit date range capped at one year
- Exercise and activity logs after a given date, with a limit
- Nutrition: a full food log for one date with daily totals and individual entries carrying calories, protein, carbs, fat, fibre and sodium, plus caloriesIn and water as a period or over a range of up to 1,095 days
- Daily activity summaries with goals, steps, calories, distances and heart rate zones
- Activity goals for daily and weekly periods, covering steps, distance, calories, floors, active minutes and active zone minutes
- Activity time series over a range of up to 30 days for steps, distance, calories, activityCalories and caloriesBMR
- Active Zone Minutes time series over up to 1,095 days, broken into fat burn, cardio and peak
- The user profile
Requirements
A Fitbit account and a registered Fitbit application, whose client ID and secret go in FITBIT_CLIENT_ID and FITBIT_CLIENT_SECRET.
Setup effort
One command plus credentials — npm install -g mcp-fitbit, then supply credentials
USE CASES
01
Working out whether last month's training changed your sleep
Sleep logs and the activity series cover the same window, and Active Zone Minutes separate a hard session from a long one, so intensity and rest can be lined up against each other rather than recalled.
02
Explaining a weight trend with what you actually ate
The weight series sets the question, the food log answers it day by day with calories and macronutrients, and the nutrition range extends the same measure back across months.
03
Reviewing how a training block actually went
The logged sessions come back as a list after a date you name, the daily summary supplies steps, calories, distances and heart rate zones around them, and the goals say what any of it was measured against.
04
Checking whether your resting heart rate has drifted
A period ending today answers the quick version; the explicit date range answers the version worth trusting, over a window the API allows up to 1 year.
13 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_activity_timeseries
Get the raw JSON response for activity time series data from Fitbit over a date range (max 30 days). Supports various resource paths like 'steps', 'distance', 'calories', 'activityCalories', 'caloriesBMR'.
get_azm_timeseries
Get the raw JSON response for Active Zone Minutes (AZM) time series data from Fitbit over a date range (max 1095 days). Returns total AZM plus breakdown by fat burn, cardio, and peak zones.
get_daily_activity_summary
Get the raw JSON response for daily activity summary from Fitbit for a specific date. Includes goals, steps, calories, distances, and heart rate zones. Requires a 'date' parameter in YYYY-MM-DD format.
get_exercises
Get the raw JSON response for exercise and activity logs from Fitbit after a specific date. Requires 'afterDate' parameter in 'YYYY-MM-DD' format. Retrieves a detailed list of logged exercises and activities.
get_food_log
Get comprehensive nutrition data (calories, protein, carbs, fat, fiber, sodium) from Fitbit food log for a specific date. Returns daily summary totals and individual food entries with nutritional values.
get_heart_rate
Get the raw JSON response for heart rate data from Fitbit for a specified period ending today or on a specific date. Requires a 'period' parameter such as '1d', '7d', '30d', '1w', '1m' and optionally accepts 'date' parameter.
get_heart_rate_by_date_range
Get the raw JSON response for heart rate data from Fitbit for a specific date range. Requires 'startDate' and 'endDate' parameters in 'YYYY-MM-DD' format. Note: The API enforces a maximum range of 1 year.
get_nutrition
Get the raw JSON response for nutrition data from Fitbit for a specified resource and period ending today or on a specific date. Requires 'resource' parameter (caloriesIn, water) and 'period' parameter such as '1d', '7d', '30d', '1w', '1m', '3m', '6m', '1y' and optionally accepts 'date' parameter.
get_nutrition_by_date_range
Get the raw JSON response for nutrition data from Fitbit for a specific resource and date range. Requires 'resource' parameter (caloriesIn, water), 'startDate' and 'endDate' parameters in 'YYYY-MM-DD' format. Note: The API enforces a maximum range of 1,095 days.
get_profile
Get the raw JSON response for the user's Fitbit profile.
get_sleep_by_date_range
Get the raw JSON response for sleep logs from Fitbit for a specific date range. Requires 'startDate' and 'endDate' parameters in 'YYYY-MM-DD' format. Note: The API enforces a maximum range of 100 days.
get_weight
Get the raw JSON response for weight entries from Fitbit for a specified period ending today. Requires a 'period' parameter such as '1d', '7d', '30d', '3m', '6m', '1y'
BEFORE YOU INSTALL
What to know first
Tools you get
13 tools when we connected. Every tool reads; none logs food, weight or activity back to Fitbit. Ranges are capped: sleep at 100 days per call, activity time series at 30 days, heart rate at one year.
Requires
- FITBIT_CLIENT_ID in your environment
- FITBIT_CLIENT_SECRET in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 13 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g mcp-fitbitMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"fitbit": {
"command": "mcp-fitbit",
"args": [],
"env": {
"FITBIT_CLIENT_ID": "<YOUR_FITBIT_CLIENT_ID>",
"FITBIT_CLIENT_SECRET": "<YOUR_FITBIT_CLIENT_SECRET>"
}
}
}
}
