Extract health and fitness data from Garmin Connect including activities, sleep, heart rate, stress, steps, and body composition. Use when the user asks about their Garmin data, fitness metrics, sleep
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
This skill enables extraction of health and fitness data from Garmin Connect for analysis and insights.
garmerBefore using garmer, authenticate with Garmin Connect:
garmer login
This will prompt for your Garmin Connect email and password. Tokens are saved to
~/.garmer/garmin_tokensTo check authentication status:
garmer status
Get today's health summary (steps, calories, heart rate, stress):
garmer summary # For a specific date: garmer summary --date 2025-01-15 # Include last night's sleep data: garmer summary --with-sleep garmer summary -s # JSON output for programmatic use: garmer summary --json # Combine flags: garmer summary --date 2025-01-15 --with-sleep --json
Get sleep analysis (duration, phases, score, HRV):
garmer sleep # For a specific date: garmer sleep --date 2025-01-15
List recent fitness activities:
garmer activities # Limit number of results: garmer activities --limit 5 # Filter by specific date: garmer activities --date 2025-01-15 # JSON output for programmatic use: garmer activities --json
Get detailed information for a single activity:
# Latest activity: garmer activity # Specific activity by ID: garmer activity 12345678 # Include lap data: garmer activity --laps # Include heart rate zone data: garmer activity --zones # JSON output: garmer activity --json # Combine flags: garmer activity 12345678 --laps --zones --json
Get comprehensive health data for a day:
garmer snapshot # For a specific date: garmer snapshot --date 2025-01-15 # As JSON for programmatic use: garmer snapshot --json
Export multiple days of data to JSON:
# Last 7 days (default) garmer exportCustom date range
garmer export --start-date 2025-01-01 --end-date 2025-01-31 --output my_data.json
Last N days
garmer export --days 14
# Update garmer to latest version (git pull): garmer updateShow version information:
garmer version
For more complex data processing, use the Python API:
from garmer import GarminClient from datetime import date, timedeltaUse saved tokens
client = GarminClient.from_saved_tokens()
Or login with credentials
client = GarminClient.from_credentials(email="user@example.com", password="pass")
# Get user profile profile = client.get_user_profile() print(f"User: {profile.display_name}")Get registered devices
devices = client.get_user_devices()
# Get daily summary (defaults to today) summary = client.get_daily_summary() print(f"Steps: {summary.total_steps}")Get for specific date
summary = client.get_daily_summary(date(2025, 1, 15))
Get weekly summary
weekly = client.get_weekly_summary()
# Get sleep data (defaults to today) sleep = client.get_sleep() print(f"Sleep: {sleep.total_sleep_hours:.1f} hours")Get last night's sleep
sleep = client.get_last_night_sleep()
Get sleep for date range
sleep_data = client.get_sleep_range( start_date=date(2025, 1, 1), end_date=date(2025, 1, 7) )
# Get recent activities activities = client.get_recent_activities(limit=5) for activity in activities: print(f"{activity.activity_name}: {activity.distance_km:.1f} km")Get activities with filters
activities = client.get_activities( start_date=date(2025, 1, 1), end_date=date(2025, 1, 31), activity_type="running", limit=20 )
Get single activity by ID
activity = client.get_activity(12345678)
# Get heart rate data for a day hr = client.get_heart_rate() print(f"Resting HR: {hr.resting_heart_rate} bpm")Get just resting heart rate
resting_hr = client.get_resting_heart_rate(date(2025, 1, 15))
# Get stress data stress = client.get_stress() print(f"Avg stress: {stress.avg_stress_level}")Get body battery data
battery = client.get_body_battery()
# Get detailed step data steps = client.get_steps() print(f"Total: {steps.total_steps}, Goal: {steps.step_goal}")Get just total steps
total = client.get_total_steps(date(2025, 1, 15))
# Get latest weight weight = client.get_latest_weight() print(f"Weight: {weight.weight_kg} kg")Get weight for specific date
weight = client.get_weight(date(2025, 1, 15))
Get full body composition
body = client.get_body_composition()
# Get hydration data hydration = client.get_hydration() print(f"Intake: {hydration.total_intake_ml} ml")Get respiration data
resp = client.get_respiration() print(f"Avg breathing: {resp.avg_waking_respiration} breaths/min")
# Get health snapshot (all metrics for a day) snapshot = client.get_health_snapshot() # Returns: daily_summary, sleep, heart_rate, stress, steps, hydration, respirationGet weekly health report with trends
report = client.get_weekly_health_report()
Returns: activities summary, sleep stats, steps stats, HR trends, stress trends
Export data for date range
data = client.export_data( start_date=date(2025, 1, 1), end_date=date(2025, 1, 31), include_activities=True, include_sleep=True, include_daily=True )
When a user asks "How did I sleep?" or "What's my health summary?":
garmer snapshot --json
When a user asks about workouts or exercise:
garmer activities --limit 10
When analyzing health trends over time:
garmer export --days 30 --output health_data.json
Then process the JSON file with Python for analysis.
If not authenticated:
Not logged in. Use 'garmer login' first.
If session expired, re-authenticate:
garmer login
GARMER_TOKEN_DIRGARMER_LOG_LEVELGARMER_CACHE_ENABLEDFor detailed API documentation and MoltBot integration examples, see
references/REFERENCE.mdNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.