Garmin Frisbee Analysis

Analyze Garmin health and performance data specifically for Ultimate Frisbee players. Generate interactive HTML dashboards for post-game review, tournament fatigue tracking, training load optimization, and season-long trend comparison.

Two Installation Paths

1. 1. Clawdbot Skill (this guide) — Use with Clawdbot for natural language queries and proactive monitoring
2. MCP Server (see MCP setup guide) — Use with Claude Desktop as an MCP server

Setup (first time only)

1. Install Dependencies

CODEBLOCK0

Pinned versions are in requirements.txt:

• - garminconnect>=0.2.19 — Garmin Connect API client
• INLINECODE1 — FIT file parsing for activity data
• INLINECODE2 — GPX file parsing

2. Configure Credentials

Why email + password? Garmin does not expose a public OAuth API. The garminconnect library authenticates via Garmin's SSO, the same flow as the Garmin Connect mobile app. The password is used once during login and is never written to disk or logged. The resulting session token is then stored locally at ~/.clawdbot/garmin/ (permissions 700); all subsequent API requests use that token, not the password.

Set GARMIN_EMAIL and GARMIN_PASSWORD in your shell profile (~/.zshrc or ~/.bashrc):

CODEBLOCK1

3. Authenticate

CODEBLOCK2

Frisbee Scripts

Post-Game / Post-Training Analysis

Analyze a single activity in depth: sprints, speed, heart rate zones.

CODEBLOCK3

Dashboard includes:

• - Summary cards: duration, distance, sprint count, top speed, sprint fatigue index, high-intensity distance
• Speed timeline with sprint highlight bands
• Sprint peak speed trend (detects fatigue: are later sprints slower?)
• Heart rate zone distribution (Zone 1–6)

Sprint detection: speed > 14.4 km/h sustained ≥ 2 seconds.
Sprint Fatigue Index: last 3 sprint peaks ÷ first 3 sprint peaks. < 0.85 = significant fatigue.

Tournament Review Dashboard

Full overview of a multi-day tournament: fatigue curve, game intensity, heart rate recovery, overnight sleep/HRV.

CODEBLOCK4

Dashboard includes:

• - Body Battery fatigue curve across tournament days (includes day-before baseline)
• Per-game avg/max heart rate comparison
• Heart Rate Recovery curves post-game (30 min window, all games overlaid)
• Overnight sleep hours + HRV per tournament night
• Activity table with all detected games

Comparison Analysis

Compare training sessions, games, or the full season.

CODEBLOCK5

Activity classification uses name keywords:

• - Game: game, match, tournament, vs, INLINECODE13
• Training: practice, training, train, drill, INLINECODE18

Dashboard includes:

• - Top speed trend over time (training vs game color-coded in cross mode)
• Avg heart rate per activity (color by intensity)
• Morning HRV on day of each activity
• Volume trend: duration + distance over time
• Full activity table

General Garmin Data

CODEBLOCK6

General Health Charts

CODEBLOCK7

Answering Frisbee Questions

Data Availability (Garmin 265S)

Key Frisbee Metrics Explained

Sprint Fatigue Index

Heart Rate Recovery (HRR)

Body Battery (0–100)

Heart Rate Zones

• - Zone 4 (70–80% max): Sustained hard effort — hallmark of well-executed frisbee
• Zone 5–6 (80–100% max): Explosive sprints and close contests
• High Zone 4–6 in training = adequate game-prep intensity

Troubleshooting

• - "FIT file download failed": Check activity ID; some activity types may not export FIT
• No sprints detected: Activity may not include speed data, or you used a non-GPS mode
• HRR chart empty: Intraday HR not available for that date; ensure "All-day HR monitoring" is on in Garmin settings
• Activities not classified: Name your activities with keywords like "game vs X" or "practice" — see classification keywords above
• Tokens expired: Re-run INLINECODE35

Privacy & Security

Credentials

• - GARMIN_EMAIL and GARMIN_PASSWORD are read from environment variables at runtime only
• The Garmin password is never written to disk or logged — used only during the authentication step, then discarded
• No config file stores credentials

Session tokens

• - Stored in ~/.clawdbot/garmin/ with directory permissions 700 (owner read/write/execute only)
• Managed by the garth library (part of garminconnect); format is an opaque token bundle, not plaintext password
• To revoke: rm -rf ~/.clawdbot/garmin/ — next login will re-authenticate

Network

• - Credentials are used only to authenticate with Garmin Connect and are not transmitted to any third-party service
• All API calls go to connect.garmin.com only
• Generated HTML dashboards load Chart.js from cdn.jsdelivr.net (versions pinned: chart.js@4.4.0, chartjs-plugin-annotation@3.0.1) — requires internet access when viewing dashboards

References

• - references/api.md — Garmin Connect API details
• INLINECODE48 — Science-backed metric interpretation
• INLINECODE49 — Claude Desktop MCP setup

Version Info

• - Version: 1.1.3
• Created: 2026-03-11
• Updated: 2026-03-16
• Author: Evelyn & Claude
• License: MIT
• Dependencies: garminconnect, fitparse, gpxpy