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

My Fitbit Data

Real example chats* showing what you can do with the My Fitbit Data toolkit.

How did I sleep last night?

Tools: my_fitbit_data.get_sleep_detail

How did I sleep last night?

Executing my_fitbit_data.get_sleep_detail

You got 6h 19m of sleep last night, with 89% efficiency — solid by most standards. Stage breakdown:

  • Deep: 71 min (19%) — right in the healthy range
  • REM: 52 min (14%) — a bit light, ideal is closer to 20–25%
  • Light: 4h 15m (67%)
  • Awake: 48 min (11%)

One thing to note: 21 short wake events totaling about 25 minutes. That’s on the higher side and suggests fragmented sleep — possibly noise, temperature, or stress. Otherwise a decent night.

Show me a visual breakdown of my heart rate zones in my last workout.

Tools: my_fitbit_data.get_workout_sessions

Show me a visual breakdown of my heart rate zones in my last workout.

Executing my_fitbit_data.get_workout_sessions
Activity
Walk
Duration
27 min
Avg HR
135 bpm
Calories
214
  • Out of range under 50% max HR
  • Fat burn 50–69%
  • Cardio 70–84%
  • Peak 85%+

Strong session — that 27-minute walk on April 22 was much more intense than your usual pace. You spent 9 minutes in cardio zone and 3 minutes in peak, which together is about 44% of the workout in serious training territory. The fat-burn 10 minutes likely covers your warm-up and cool-down. Average HR of 135 confirms it — well above your typical walking pace.

If you can hit this kind of zone distribution two or three times a week, you’re getting real cardiovascular benefit. The peak time especially helps with VO2 max over time.