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