← Back to Skills Marketplace
eversonl

Garmin Health Analysis

by eversonl · GitHub ↗ · v1.2.2
cross-platform ⚠ suspicious
6304
Downloads
12
Stars
0
Active Installs
11
Versions
Install in OpenClaw
/install garmin-health-analysis
Description
Talk to your Garmin data naturally - "what was my fastest speed snowboarding?", "how did I sleep last night?", "what was my heart rate at 3pm?". Access 20+ metrics (sleep stages, Body Battery, HRV, VO2 max, training readiness, body composition, SPO2), download FIT/GPX files for route analysis, query elevation/pace at any point, and generate interactive health dashboards. From casual "show me this week's workouts" to deep "analyze my recovery vs training load".
Usage Guidance
Review before installing. Use an isolated virtual environment with pinned dependencies, avoid entering passwords on the command line or storing them in plaintext config files, protect or delete ~/.clawdbot/garmin token material when revoking access, choose a private output directory for activity files, and avoid generated dashboards unless you accept the third-party Chart.js CDN exposure.
Capability Analysis
Type: OpenClaw Skill Name: garmin-health-analysis Version: 1.2.2 The OpenClaw skill 'garmin-health-analysis' is designed to fetch, analyze, and visualize personal health data from Garmin Connect. All code and documentation align with this stated purpose. Sensitive Garmin credentials are handled by storing session tokens locally in `~/.clawdbot/garmin` with secure permissions (0o700), and all network interactions are directed solely to Garmin's official API via the `garminconnect` library. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, or prompt injection attempts against the agent that would lead to harmful behavior beyond the skill's stated scope. The instructions for the AI agent in `SKILL.md` and `references/health_analysis.md` are clear and guide the agent in performing legitimate health data analysis and reporting.
Capability Assessment
⚠ Credentials
Local file use is expected, but the default /tmp activity download path is predictable for sensitive GPS/biometric files, dashboards embed private data while loading Chart.js from a third-party CDN, and documentation claims no non-Garmin data flow.
⚠ Install Mechanism
The installer uses unpinned pip installs, suppresses install errors, falls back to --break-system-packages and system-wide installation, and creates a plaintext config.json credentials file without restrictive permissions.
⚠ Instruction Scope
The instructions use broad health-query triggers and direct agents to fetch and print raw Garmin JSON, including health telemetry and an optional profile command with name/email, without strong consent, minimization, or logging guidance.
⚠ Persistence & Privilege
Persistent session tokens are disclosed and purpose-aligned, but the implementation stores tokens in ~/.clawdbot/garmin while documentation points users to different token-file paths for revocation; plaintext password storage is also recommended as an option.
ℹ Purpose & Capability
The package purpose coherently matches Garmin health and activity analysis: it authenticates to Garmin, fetches health/activity metrics, downloads FIT/GPX/TCX files, queries activity points, and generates dashboards. These capabilities are sensitive but generally purpose-aligned.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install garmin-health-analysis
  3. After installation, invoke the skill by name or use /garmin-health-analysis
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
Repository cleanup: Removed old MCP server files (CLAUDE_DESKTOP.md, mcp_server.py, requirements.txt). This repo is now focused exclusively on the Clawdbot skill for automated health monitoring. Claude Desktop users should use the dedicated MCP server at github.com/eversonl/garmin-health-mcp-server. Both can coexist with shared authentication.
v1.2.1
Repository cleanup: Removed old MCP server files, focused repo on Clawdbot skill. Directs Claude Desktop users to dedicated MCP server repo (github.com/eversonl/garmin-health-mcp-server). Both can coexist with shared authentication.
v1.2.0
MCP server for Claude Desktop & Code
v1.1.5
Talk to your data - conversational examples
v1.1.4
Docs update
v1.1.3
Updated Version Info section documentation
v1.1.2
Updated description and author metadata
v1.1.1
Time queries, extended metrics, FIT/GPX analysis
v1.1.0
Major update: Time-based queries, 15+ new metrics (training readiness, body comp, SPO2), FIT/GPX file analysis for detailed activity insights
v1.0.1
Fixed sleep data extraction - properly parse nested dailySleepDTO object from Garmin API
v1.0.0
Initial release: Fetch and visualize Garmin health data (sleep, Body Battery, HRV, activities) with interactive charts
Metadata
Slug garmin-health-analysis
Version 1.2.2
License —
All-time Installs 0
Active Installs 0
Total Versions 11
Frequently Asked Questions

What is Garmin Health Analysis?

Talk to your Garmin data naturally - "what was my fastest speed snowboarding?", "how did I sleep last night?", "what was my heart rate at 3pm?". Access 20+ metrics (sleep stages, Body Battery, HRV, VO2 max, training readiness, body composition, SPO2), download FIT/GPX files for route analysis, query elevation/pace at any point, and generate interactive health dashboards. From casual "show me this week's workouts" to deep "analyze my recovery vs training load". It is an AI Agent Skill for Claude Code / OpenClaw, with 6304 downloads so far.

How do I install Garmin Health Analysis?

Run "/install garmin-health-analysis" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Garmin Health Analysis free?

Yes, Garmin Health Analysis is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Garmin Health Analysis support?

Garmin Health Analysis is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Garmin Health Analysis?

It is built and maintained by eversonl (@eversonl); the current version is v1.2.2.

💬 Comments