Version 0.1.0

⚠️ Breaking

Package renamed to @macakdev/gc-mcp (was @ace4seven/gc-mcp). Future releases go to the new scope only.

npm uninstall -g @ace4seven/gc-mcp
npx @macakdev/gc-mcp setup

Existing MCP client configs still point at the old package. Re-running setup rewrites them for every detected client; alternatively, edit the args entry by hand. Garmin tokens in ~/.gc-mcp/ are unaffected — no re-login needed.

The repository also moved to github.com/macakdev/GC-MCP.

🐛 Fixed

Published package was missing dist/coach/. The files glob dist/.js matched only top-level files, so every coach tool crashed at startup with Cannot find module './coach/state'. The glob is now dist/**/.js, with dist/tests excluded. This is what made 0.0.3 unusable via npx.

Reading data from Watt meter

New MCP Tools

Cycling Power

• get_cycling_detail — per-ride power metrics (NP, IF, TSS, L/R balance, torque effectiveness)
• get_cycling_power_summary — aggregated power history over a configurable window
• get_cycling_fitness — CTL/ATL/TSB fitness model derived from TSS history
• coach_compute_cycling_load — computes CTL/ATL/TSB with automatic FTP fallback for use by the coach

Gear & Shifting

• list_activities_with_gear — lists recent activities annotated with the gear used
• get_cycling_shifts — surfaces Shimano Di2 shifting metrics (shift counts, front/rear distribution) for supported
  devices

---

Cycling Power Engine (src/cycling-power.ts)

New computation module implementing:

• TSS calculation from Garmin activity data
• CTL (42-day chronic training load) and ATL (7-day acute training load) via exponential decay model
• TSB (Training Stress Balance = CTL − ATL) — the fitness/fatigue indicator

---

Coach Integration

• TSB is now wired into readiness synthesis — a TSB below −20 triggers a load deviation warning
• Coach-core skill (rule 9) gains CTL/ATL/TSB interpretation guidance
• L/R power balance flag raised when imbalance exceeds 47–53% across 3+ rides
• coach-today, coach-plan-week, and coach-onboard commands updated accordingly

---

Install / Update

npm install -g @ace4seven/gc-mcp@0.0.3

AI Fitness Coach Plugin

What's new

This release adds gc-coach — a Claude Code plugin that turns Claude into a
personalised fitness coach on top of your Garmin Connect data.

Plugin (install via Claude Code)

/plugin marketplace add ace4seven/GC-MCP
/plugin install gc-coach@gc-mcp-marketplace

5 slash commands: /coach-onboard, /coach-today, /coach-checkin,
/coach-plan-week, /coach-review

8 skills: coach-core, onboarding, daily-advisor, recovery-advisor,
pattern-detective, weekly-planner, endurance-block, strength-block

All coaching state is stored locally in ~/.gc-mcp/coach/ — no cloud sync.

New MCP tools (available without the plugin)

Tool	Description
coach_state	Read/write athlete profile, goals, weekly plan, daily log, flags, reviews
coach_log_subjective	Append a daily check-in (energy, soreness, sleep, RPE)
coach_compute_load_summary	7d/28d ACWR, trend, and per-modality load breakdown
coach_compute_readiness_synthesis	Composite readiness score + go_hard / moderate / easy / rest tier

Requirements

• Garmin OAuth tokens set up via npx @ace4seven/gc-mcp setup
• Claude Code (CLI, desktop app, or claude.ai/code)