Skip to content

Garmin Connect skill for Claude Code and OpenClaw. Training analysis, sleep trends, performance analytics, AI coaching.

Notifications You must be signed in to change notification settings

nftechie/garmin-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 

Repository files navigation

Garmin Skill

Chat with your Garmin Connect data using AI. Ask about your runs, rides, swims, training load, VO2 Max, heart rate zones, sleep, and performance trends.

Powered by Transition

Quick Start

Try it right now — no API key needed:

curl "https://api.transition.fun/api/v1/wod?sport=run&duration=45"

For personalized features (your Garmin data, training plan, AI coach), you need a Transition account + API key. See Getting an API Key below.


Two Ways to Use This

1. Claude Code / OpenClaw Skill (Recommended)

The simplest option. Claude reads the skill file and calls the API directly — no binary, no MCP protocol, just HTTP. Also available on OpenClaw.

# Clone into your skills directory
git clone https://github.com/nftechie/garmin-skill.git ~/.claude/skills/garmin-skill

Set your API key:

# Add to your shell profile (~/.zshrc, ~/.bashrc, etc.)
export TRANSITION_API_KEY="tr_live_xxxxxxxxxxxxxxxxxxxxx"

Now in Claude Code, you can say things like:

  • "How has my running volume changed this month?"
  • "What's my VO2 Max trend?"
  • "Am I overtraining based on my recent Garmin data?"
  • "Compare my cycling power this month vs last month"
  • "How's my sleep been this week?"

Claude reads SKILL.md and knows how to call every endpoint.

2. Direct API

Use the API from scripts, automations, or any HTTP client. See SKILL.md for complete endpoint documentation with curl examples.

# Ask the AI coach about your Garmin data
curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "How has my running volume changed this month compared to last?"}' \
  "https://api.transition.fun/api/v1/coach/chat"

# Get your fitness/fatigue/form metrics
curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/pmc"

Getting an API Key

  1. Download Transition (iOS/Android)
  2. Create an account and connect your Garmin Connect account
  3. Go to Settings > API Keys
  4. Tap Generate New Key — you'll see a key starting with tr_live_
  5. Copy it immediately (it's only shown once)

Free tier includes 100 read requests/day and 3 AI requests/day. Plenty for personal use.

Rate Limits

Tier Read Endpoints AI Endpoints
Free 100/day 3/day
Paid 10,000/day 100/day

Read: workouts, metrics, profile, history | AI: coach chat, adapt, generate

License

MIT

About

Garmin Connect skill for Claude Code and OpenClaw. Training analysis, sleep trends, performance analytics, AI coaching.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published