MCP App Store
by KeenEthics
Fit File Forge icon

Fit File Forge MCP Server for Claude and ChatGPT

By Forge Labs LLC

Overview

Read (activity data needs Garmin Connect linked in Fit File Forge with activity sharing on): - Find and analyze sessions: summaries, laps and splits, time in zones, heart rate, pace, power, cadence and elevation, plus an optional cleaned time series for charts. - Compare similar sessions; see weekly trends and fitness, fatigue and form (CTL/ATL/TSB). - Race-time predictions and best efforts from recent training. - Your goal and planned workouts, day by day, in a calendar card. Write: - Build structured running, cycling, swimming, strength and multisport workouts from a plain-language description, shown step by step in a workouts card. - Edit a saved workout, or move workouts to other dates. - Send saved workouts to your Garmin watch and calendar, only when you ask. You sign in with your Fit File Forge account and choose what Claude may see and do: profile, activities, activity time series, reading workouts, writing workouts, and sending to Garmin. Disconnect any time in Claude or in Fit File Forge (Settings > Connected Apps). Never shared: GPS locations or routes, original activity files, and health data such as sleep or HRV, which Fit File Forge does not collect. Training information only, not medical advice. Requires a Fit File Forge account. Every tool except the account summary needs Fit File Forge Pro or its 14-day trial. Garmin and Garmin Connect are trademarks of Garmin Ltd. or its subsidiaries. Fit File Forge is not sponsored or endorsed by Garmin.

How to connect

  1. Claude: Open the Fit File Forge listing in the Claude connectors directory and choose Connect. Claude listing Fit File Forge exposes 14 tools here.
  2. ChatGPT: Open the Fit File Forge listing in the ChatGPT app directory and choose Connect. ChatGPT listing Fit File Forge exposes 14 tools here.

Tools

build_workouts

ChatGPT
Use this when the athlete wants structured workouts made — one session or up to seven (a week). Describe each session in plain words ("4 × 8 min at threshold with 2 min jog", "60 min easy ride Z2", "swim 10 × 100 on 1:45", strength, multisport) with its date; Fit File Forge builds a valid Garmin workout in the athlete's units, using the thresholds saved in their profile, and saves it to their Fit File Forge calendar. When get_athlete shows a threshold as estimated or missing, put the target in the description ("at 4:35/km", "at 250 W", "HR 150–160"). Don't write steps or JSON yourself. A request Fit File Forge can't build (such as a whole multi-week plan as one session) comes back unbuilt with a suggestion. Builds count toward the athlete's Fit File Forge usage limits. Each call creates new workouts, so calling it again for the same sessions makes duplicates. Nothing is sent to the watch: show the result and use send_to_garmin when the athlete asks. Don't use this for advice the athlete didn't ask to have built.

compare_activities

ChatGPT
Use this to compare two sessions of the same kind side by side (pace or power, heart rate, efficiency, decoupling, load, laps): "is this tempo better than last month's?". Put the earlier or baseline session first; ids come from find_activities.

edit_workout

ChatGPT
Use this only when the athlete asks to change a specific saved workout, in plain words ("make the reps 3 minutes", "ease it to Z2", "rename it", "move the cooldown to 15 min"). Fit File Forge rebuilds and re-validates it, replacing the saved version and keeping its date. Find the id with get_calendar. Don't use this to move it to another day (schedule_workouts) or to make a different workout (build_workouts).

find_activities

ChatGPT
Use this to find the athlete's synced activities by date range, sport, minimum distance or name ("my long run two Sundays ago", "rides over 80 km in August") or to list a period, newest first. Each hit has an id and a one-line summary (time, distance, normalised pace or power, heart rate avg/max, training load, decoupling, climb). Pass ids to get_activity or compare_activities; never ask the athlete for ids. For weekly totals or volume over weeks use get_trends instead. Defaults: last 90 days, all sports, 10 results (max 25). Dates are the athlete's local YYYY-MM-DD.

get_activity

ChatGPT
Use this to look inside one activity. depth: summary (headline numbers, load, decoupling, efficiency), laps (per lap with per-lap normalised power for rides), zones (time in heart-rate/pace/power zones on the athlete's own thresholds), efforts (best efforts inside the session), full (all of it). Laps list up to 25; for more, use get_activity_splits by lap. Activities Garmin sent only as a summary have no laps or zones (dataNotes says so). When the athlete asks how a session went or to analyse it, use full together with get_activity_splits and, when it's available, get_activity_series; use a smaller depth for a quick question about one number.

get_activity_series

ChatGPT
Use this when the athlete wants one activity analysed in detail or charted — how it went, pacing, heart-rate drift, climbs, interval execution, cadence vs pace: Fit File Forge's cleaned time series, units in the column names, t_s = seconds from the start. format: json (default — one array per column, index-aligned to t_s, null = not recorded; load it straight into a dataframe) or csv. Pick only the channels you need. resolution_s: 1, 2, 5, 10, 15, 30 or 60; omit for the finest that fits the whole activity on one page. Long results come in pages — pass next_cursor to continue. Never includes location. For splits or summaries use get_activity_splits or get_activity instead.

get_activity_splits

ChatGPT
Use this for pacing and execution questions: an analysis-ready table of one activity split by km, mile, lap, minute or 5 minutes — elapsed and moving time, distance, pace (and grade-adjusted pace for runs), average/max heart rate, power, cadence, climb and descent per split. Optional from_s/to_s (seconds from the start) to look at part of the session, e.g. the last 10 minutes. Compact enough for any session; prefer it over the time series unless you need per-second detail.

get_athlete

ChatGPT
Use this first in a conversation about the athlete's training: thresholds and zones inputs (max/threshold heart rate, threshold pace, FTP, swim CSS, each with its source), units and time zone, their Fit File Forge plan and whether the connector's tools are available to them, Garmin connection and sharing state, and how much activity history Fit File Forge holds. Not for sleep, HRV, stress or other health data (not collected).

get_calendar

ChatGPT
Use this for "what's on this week" and before planning, moving or sending anything: every workout the athlete has scheduled in Fit File Forge between two dates (name, sport, planned minutes, whether it's already on their Garmin watch, the goal it belongs to), plus rest days and empty days. Default: today and the next 13 days; max 120 days. Refer to workouts by name and date, not id.

get_performance

ChatGPT
Use this for what the athlete can do now. kind: best_efforts (fastest times or highest powers over standard distances/durations, with the session each came from), race_prediction (running only: 5k, 10k, half, marathon or a custom distance, with confidence and the effort it rests on), thresholds (estimated max/threshold heart rate, threshold pace, FTP and swim CSS from their activities, to compare with what's in their profile), power_curve (best power for each duration, cycling). range: 4w, 12w, 26w or 52w (best_efforts, power_curve).

get_training_status

ChatGPT
Use this for "how am I doing?", fatigue, freshness or load questions: fitness, fatigue and form (CTL/ATL/TSB), the acute:chronic load ratio, recent weekly volume and a one-line reading with its confidence. Not a medical or recovery assessment: Fit File Forge has no sleep or HRV data.

schedule_workouts

ChatGPT
Use this to put saved workouts on dates, move them, or take them off the calendar (date null). If a workout is already on the athlete's watch, its Garmin calendar entry moves too. Never stack missed sessions onto later days unless the athlete asks. Find ids with get_calendar.

send_to_garmin

ChatGPT
Use this only when the athlete has asked to put specific saved workouts on their Garmin watch: it sends each one (and its date to the Garmin calendar). Asking for advice or a plan is not asking to send. Reports per workout whether it was sent; never say a workout is on the watch unless sent is true. If Garmin isn't connected, or the athlete hasn't allowed sending workouts, the result says what they need to do on fitfileforge.com. If a call times out, check get_calendar (on_watch) before trying again.

build_workouts

Claude

compare_activities

Claude

edit_workout

Claude

find_activities

Claude

get_activity

Claude

get_activity_series

Claude

get_activity_splits

Claude

get_athlete

Claude

get_calendar

Claude

get_performance

Claude

get_training_status

Claude

schedule_workouts

Claude

send_to_garmin

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/fit-file-forge"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/fit-file-forge)