Zsadigzade/trainbud

**Talk to your training data.**
TrainBud is an open-source MCP server that connects your Garmin Connect fitness data to Claude, Cursor, and other AI assistants. Ask about workouts, sleep, heart rate, recovery, and body composition in plain English — privately, on your machine.
> **Disclaimer:** TrainBud is an unofficial community project. It is not affiliated with, endorsed by, or sponsored by Garmin Ltd. Garmin Connect is a trademark of Garmin Ltd.
Try it
Once connected to your MCP client, ask things like:
- *"What did I do today?"*
- *"How's my sleep been this week?"*
- *"Am I recovered enough to train hard tomorrow?"*
- *"Is my resting heart rate trending down?"*
See examples/prompts.md for more ideas.
Why TrainBud
- **Private** — credentials stay in your local .env; data is cached on your machine
- **Local-first** — SQLite cache, session tokens in .trainbud/
- **Works everywhere** — Windows, macOS, Linux (Node.js 22.12+)
- **Any MCP client** — Claude Desktop, Cursor, and other stdio-compatible clients
- **Smart fetching** — batched API calls and automatic re-auth when sessions expire
Quick start
The setup wizard walks you through credentials, authentication, and connecting Cursor or
Claude Desktop — no MCP config editing required. Then restart your MCP client and ask it
what you did today.
To keep trainbud on your PATH instead of typing npx every time:
Needs Node 22.12+. Full walkthrough: QUICKSTART.md
From source (for contributors, or to run an unreleased commit)
Without npm link, every trainbud in this README is
node dist/index.js run from the repo root. If dist/ does not exist yet,
run npm run build first.
Claude Code plugin (recommended)
Install as a Claude Code plugin — skills **and** MCP server in one step:
Set credentials, then restart Claude Code:
| Command | What it does |
|---------|----------------|
| /trainbud:trainbud-setup | First-time setup and diagnostics |
| /trainbud:trainbud | Ask about workouts, sleep, recovery, HR, stress, VO2 max |
Plugin files live in plugin/. See plugin/README.md.
Claude Code skills (in-repo)
This repo also ships project skills in .claude/skills/ for development without installing the plugin:
| Command | What it does |
|---------|----------------|
| /trainbud-setup | Install, authenticate, configure MCP, run live check |
| /trainbud | Ask about workouts, sleep, recovery, HR, stress, VO2 max |
Open the repo in **Claude Code** (claude in this directory) — skills load automatically.
To use skills in **every** project without the plugin, copy them to ~/.claude/skills/.
After setup, restart your MCP client and try /trainbud with *"What did I do today?"*
Dashboard
trainbud serve hosts a dashboard at /dashboard. It is phone-first, because the
pairing flow is: you are standing next to the watch holding a phone when you approve a
code.
It shows what stands out today against your own baselines, this week against last week,
and resting heart rate and sleep plotted against your own 30-day median — all read from
the local history store, so it paints instantly and works even when your Connect session
has expired. **A break in a line is a day with no measurement, not a zero.**
It is also where you tell TrainBud who it is talking to:
| Setting | What it changes |
|---|---|
| Name, units, primary sport, weekly goal | Every renderer, and what the AI is told about you |
| Thresholds | Where green becomes amber and amber becomes red — on the watch too |
| Watch cards | Which cards appear on the wrist and in what order, live on the next sync |
| AI model, tone, answer length | How the Ask card and the daily insight sound |
| Your own Ask questions | Up to five, 32 characters each. They lead the watch's Ask menu; the rest of the slots stay generated from what fired |
| Monthly spending cap | Optional. Refuses an Ask past the cap instead of spending past it |
| Privacy | Local feature counters, on by default, with a delete button |
**Usage.** TrainBud runs on your own AI provider key, so every question and every daily
insight is charged to you. The dashboard shows the tokens and cost per call, the month to