freakyflow/garminskill
Overview
This skill syncs daily health and fitness data from Garmin Connect into human-readable markdown files for use by your AI agent or personal notes. It collects sleep, activity, heart rate, stress, body battery, HRV, SpO2, and weight data and writes one markdown file per date. Setup is a one-time authenticated login that caches tokens locally so subsequent syncs need no credentials. Files are stored in a local health directory for easy reading and automation.
How this skill works
The skill runs a Python sync script that authenticates with Garmin Connect once to obtain OAuth tokens, then uses the cached tokens for all future syncs. It fetches the day’s metrics and writes a structured markdown file at {baseDir}/health/YYYY-MM-DD.md. You can sync today, a specific date, or a range of past days; missing files can be created by running the sync for the requested date.
When to use it
- Get daily health summaries for your agent or journal
- Automate morning syncs to keep records current
- Answer questions about specific dates or recent trends
- Ingest data into a personal knowledge base or agent memory
- Review sleep, HR, stress, HRV, SpO2, and weight for health tracking
Best practices
- Perform the one-time setup from a secure terminal; the password is used only interactively and not stored
- Schedule the sync script to run daily (cron) so files are available every morning
- Keep the token cache (~/.garminconnect) private and backed up if desired
- Read files from {baseDir}/health/YYYY-MM-DD.md when answering questions; sync first if a file is missing
- Avoid sharing markdown files containing personal health data without redaction
Example use cases
- Daily agent prompt: pull today’s health summary into a morning briefing
- Historical query: sync and read the markdown for 2026-02-07 to answer a user’s sleep question
- Trend analysis: run a 7-day sync and aggregate nightly HRV or body battery values
- Automated journaling: append agent-generated insights to your personal log using each day’s markdown file
FAQ
No. You authenticate once interactively to cache OAuth tokens. Subsequent syncs use the cached tokens only.
Where are the health files stored?
Daily markdown files are written to {baseDir}/health/YYYY-MM-DD.md so your agent can read specific dates easily.
What if a date’s file is missing?
Run the sync command for that date (or for a range) to create the missing markdown file.
