MCP App Store
by KeenEthics
Running Workout icon

Running Workout MCP Server for Claude and ChatGPT

By Running Workout

Overview

Running Workout connects Claude to your Garmin training. Claude reads your real activities and training profile, keeps track of your race goals and constraints, and builds structured running, cycling and swimming workouts that it schedules on your Garmin Connect calendar, so they sync to your watch. What you can do: - Get a summary of your current training: weekly volume, recent runs, reference paces such as maximal aerobic speed (VMA), goals and active plan. - Review a completed session or a whole week against what was planned. - Follow a 5K, 10K, half-marathon or marathon training plan, week by week, and push each week to the watch. - Create a one-off workout from a single sentence, for example "10 x 400 m at 95 % VMA with 1 min recovery on Thursday", with paces computed from your own data. - Record race goals, available days, equipment and coaching notes that Claude remembers from one conversation to the next. Claude asks for your confirmation before it creates, moves or deletes a workout on your calendar. Running Workout uses the official Garmin Connect Developer Program API; your Garmin password is never seen by Running Workout or by Claude, and you can revoke Claude's access at any time from your dashboard. Requires a free Running Workout account linked to Garmin Connect. Works in English and French, in kilometres or miles. Running Workout is a sports training tool and does not give medical advice.

How to connect

  1. Claude: Open the Running Workout listing in the Claude connectors directory and choose Connect. Claude listing Running Workout exposes 23 tools here.
  2. ChatGPT: Open the Running Workout listing in the ChatGPT app directory and choose Connect. ChatGPT listing Running Workout exposes 24 tools here.

Tools

add_athlete_note

ChatGPT
Append a free-text observation to the athlete's persistent memory. Use this to record test results, how a session went, schedule changes, coaching decisions, or any information that should survive beyond this session. Notes are stored in reverse chronological order and viewable on the website.

compute_vma_test

ChatGPT
Compute the athlete's VMA (km/h) from the speed samples of a completed RUNNING test activity — a 6-minute all-out effort (protocol "continuous": best 6-min rolling average) or a progressive step test such as VAMEVAL (protocol "progressive": best 60 s, last minute excluded). Same deterministic computation as the test validation on the website. Use list_activities to find the summaryId (lines marked [detail available]). READ-ONLY: nothing is stored. Present the value to the athlete; once they confirm it was a genuine all-out test, store it with set_athlete_data (key vma_kmh, basis athlete_confirmed_proposal) — the response spells out the exact call.

create_workout

ChatGPT
Create a structured running, cycling or pool-swimming workout on the user's Garmin Connect account. Provide the workout in the Running Workout JSON schema (SI units: meters, seconds, m/s). See targetType for the full per-sport target enumeration, including heart rate (percent, absolute bpm, or zone 1-5) and power (absolute watts, or zone 1-7 for CYCLING), which are now available for all three sports where it makes sense. If a relative target (VMA_PERCENT/HR_PERCENT) cannot be resolved from the athlete's profile, the call fails explicitly and names the missing data — it never silently falls back to no target. The confirmation message states which data (and its date/origin) was used to resolve any relative target. LAP_SWIMMING workouts must be distance-based: use durationType DISTANCE (meters) for all non-REST steps (OPEN is allowed for WARMUP/COOLDOWN). REST steps use durationType TIME (seconds). QUIRK: if a repeat block ends with a REST step, the watch skips that block's final rest; add an explicit REST step after the block if a rest before the next set is needed. Optionally pass scheduledDate (YYYY-MM-DD) to also schedule the workout on the Garmin calendar.

delete_scheduled_workout

ChatGPT
Remove a workout from the Garmin Connect calendar (unschedule it). This removes the calendar entry only; the workout itself remains in the Garmin workout library. Use delete_workout to also remove the workout from the library.

delete_workout

ChatGPT
Delete a workout from the Garmin Connect workout library and remove the local Running Workout copy. Garmin also removes any calendar schedule entries for the deleted workout (verified). Use delete_scheduled_workout instead if you only want to unschedule while keeping the workout in the library.

get_activity_details

ChatGPT
Retrieve a detailed report for a single completed activity stored locally (no Garmin API call). Returns: full summary (all known scalar fields), computed metrics from samples (moving duration, avg/max/normalized power, effective bike cadence, avg strokes/min), per-lap splits up to 50 (duration, distance, avg HR, avg power, pace/speed). For pool swimming (LAP_SWIMMING): per-length detail (duration, stroke type, stroke count, SWOLF, pace/100m) when available; otherwise estimated SWOLF components derived from whole-activity averages, explicitly labeled as such. Use list_activities first to obtain valid summaryIds — each line ends with the summaryId; lines marked [detail available] support this tool.

get_athlete_profile

ChatGPT
Return a Markdown synthesis of the athlete's profile: measured metrics computed from activity history combined with declared/remembered values. Always shows the origin (verified test, declared, computed) and date of each physiological figure. Call this at the start of a session to understand the athlete's current state. Computed fresh on every call from the activity history and declared values — there is no separate rebuild step to call first.

get_plan_week

ChatGPT
Show one week of the athlete's active training plan: every session dated on their chosen days, with its structure, target zones and paces derived from the athlete's VMA (in their language and units), the reason behind it, and whether it was already pushed to Garmin. Defaults to the current week. READ-ONLY. Relay the week to the athlete, then push it with schedule_plan_week.

get_wellness_summary

ChatGPT
Return the athlete's daily recovery metrics synced from Garmin, one row per day (most recent first): sleep duration and stages, Garmin sleep score, overnight HRV (average and 5-minute high, ms), resting heart rate, average and max stress level (0-100), Body Battery charged and drained, steps. Use it to adapt the training load (easier session after a short night or an HRV well below the athlete's usual value). Empty cells mean Garmin sent nothing for that day.

get_workout

ChatGPT
Read back the full content of a workout previously created through Running Workout: every step with its intensity, duration and target, repeat blocks included, plus a summary. Use it before analysing a completed session, to compare what was planned against what was done, or before rebuilding a workout — there is no in-place edit, so changing a workout means reading it, deleting it and creating a new one. Returns nothing for workouts not created here.

list_activities

ChatGPT
List completed activities received via Garmin webhooks or history import. Returns date/time, type, name, duration, distance, avg HR, avg pace and additional fields when available (max HR, bike cadence rpm, swim cadence spm, active lengths, elevation gain D+, calories). Each line ends with the summaryId; when marked [detail available], call get_activity_details for per-lap splits, power and computed metrics. This tool reads local data only — no Garmin API call is made. Activities predating the account connection may be missing unless a history import was run on runningworkout.fr.

list_athlete_constraints

ChatGPT
List the athlete's structured constraints (availability days, temporary limitations, equipment, preferences) with their id, kind, days and validity dates. Active ones by default (untilDate not passed); status "all" for history. Use the id with set_athlete_constraint to update or end one.

list_athlete_goals

ChatGPT
List the athlete's goals (races and objectives) with their id, priority, date, days remaining, distance, target time and derived target pace. Active goals by default; pass status "all" for history. Use the id with set_athlete_goal to update a goal.

list_athlete_notes

ChatGPT
List notes from the athlete's persistent memory, sorted by date descending. Note text is truncated to 300 characters when limit > 10. Returns an empty informative message when no notes match.

list_scheduled_workouts

ChatGPT
List workouts scheduled on the Garmin Connect calendar for a given date range (max 62 days). Returns date, workout name, sport, duration, distance, step count, workoutId and scheduleId for each entry. Name, sport, duration, distance and step count are only available for workouts created via Running Workout.

list_training_plans

ChatGPT
Catalogue of the coach's training plans (back to running, 5K, 10K, half-marathon, marathon): length, sessions per week, race or programme, whether a VMA is required, phases. Pass planId to get one plan's sheet plus a preview of one week (default: its peak week) rendered in the athlete's language and units, with paces from their VMA when known — WITHOUT starting anything. Marathon preview: the pace shown is graduated by VMA level only (no goal lookup here) — once actually started with a chrono goalId, start_training_plan anchors it more precisely on the target pace. Use it to show the athlete what a plan looks like before start_training_plan. READ-ONLY.

move_scheduled_workout

ChatGPT
Reschedule a workout to a different date on the Garmin Connect calendar. Both scheduleId and workoutId are required (the Garmin API requires the workoutId in the update payload).

review_plan_week

ChatGPT
Weekly review of the athlete's active plan: each planned session matched with the run recorded that day (done / missed / upcoming, duration, distance, avg HR), other runs, training load (ACWR) and the deterministic decision from the plan's rules (missed sessions → repeat week or not; ACWR → lighten / repeat / as planned). Defaults to the last completed week. READ-ONLY. Then ask the athlete how the week felt (1-5) — pain, illness and heat are YOUR call, not this tool's — write the review with add_athlete_note, and push the next week with schedule_plan_week.

schedule_plan_week

ChatGPT
Create on Garmin Connect and schedule on the Garmin calendar every session of one week of the athlete's active plan (names and descriptions in their language, targets in % VMA resolved from their profile). Sessions already pushed are skipped (never duplicated); sessions whose date is already past are skipped too. Defaults to the current week. Review the week with get_plan_week and the athlete first.

set_athlete_constraint

ChatGPT
Create or update a structured constraint the training plan must respect. kind: "availability" (which days the athlete can train — pass days), "preference" (e.g. long run on Sunday — pass days), "injury" (a temporary limitation on training — set untilDate when it no longer applies), "equipment" (track access, treadmill, gear), "other". days are ISO weekdays: 1 = Monday … 7 = Sunday. Call WITHOUT constraintId to create; WITH constraintId (from list_athlete_constraints / get_athlete_profile) to update — to end a constraint (limitation lifted, changed schedule) set untilDate to today rather than rewriting it. Only record what the athlete actually said. Rejected with an explicit message on any invalid field (no partial write).

set_athlete_data

ChatGPT
Write one or more declared values to the athlete's persistent memory. Physiological stats (vma_kmh, ftp_watts, fc_max, css_per_100m_sec) are also written to the unified stats history; other keys are declared-only. Validated before writing: unknown key, out-of-range value, wrong unit, future date, or missing/invalid basis cause full rejection (no partial write). Valid keys: weight_kg, height_cm, vma_kmh, fc_max, fc_repos, ftp_watts, css_per_100m_sec, vo2max, weekly_hours_available. IMPORTANT — DO NOT WRITE SILENTLY: You MUST NOT call this tool to record a value you inferred purely from get_athlete_profile's computed figures without one of three real conversational events having happened in this conversation: (1) the athlete told you a test result, (2) you identified an inconsistent sensor recording and the athlete confirmed the correction, or (3) you proposed updating a value based on your own analysis and the athlete explicitly said yes.

set_athlete_goal

ChatGPT
Create or update one of the athlete's goals — a race or objective with a date, and optionally a distance and a target time. Call WITHOUT goalId to create; WITH goalId (from list_athlete_goals or get_athlete_profile) to update — e.g. set status "done" after the race, "abandoned" if dropped, or adjust targetTimeSec after a reassessment. Only record what the athlete actually stated: never invent a date or a target time. For a chrono goal pass distanceM + targetTimeSec so the target pace can be derived; for a "just finish" goal omit targetTimeSec. Priority A = main goal of the season, B = secondary (default), C = training race. Rejected with an explicit message on any invalid field (no partial write).

start_training_plan

ChatGPT
Builds the athlete's plan from the parameters they saved on the site. Never asks for or accepts plan parameters. Call once without confirm to get either a link to send the athlete to (no setup yet) or the recap to read back (setup ready) — nothing is written by that first call. Call again with confirm: true only after their explicit go. planId, if passed, only pre-selects a plan on the site's wizard link when no setup exists yet — it never configures anything by itself. All other legacy arguments (raceDate, startDate, variant, days, goalId, longRunMode, replace) are accepted for backward compatibility with clients that still cache the old schema, and silently ignored. Any link in the response is already markdown-formatted ([text](url)) — relay it exactly like that so it renders clickable for the athlete: translate the visible words if you like, never touch the URL inside the parentheses, and never retype it as plain text.

update_training_plan

ChatGPT
Update the athlete's active plan: status "done" after the race (then review it with get_activity_details), or a new raceDate to shift the whole calendar (plan rule: the race must stay at least as many full weeks away as the plan needs — shortening a plan is a coaching decision, done by hand). Sessions already pushed to Garmin keep their dates: move them with move_scheduled_workout if needed. Stopping a plan is NOT done here — that is the athlete's own decision, made on the site (see the error message if you pass "abandoned" — legacy, ignored). Any link in the response is already markdown-formatted ([text](url)) — relay it exactly like that, never as plain text.

add_athlete_note

Claude

compute_vma_test

Claude

create_workout

Claude

delete_scheduled_workout

Claude

delete_workout

Claude

get_activity_details

Claude

get_athlete_profile

Claude

get_plan_week

Claude

get_workout

Claude

list_activities

Claude

list_athlete_constraints

Claude

list_athlete_goals

Claude

list_athlete_notes

Claude

list_scheduled_workouts

Claude

list_training_plans

Claude

move_scheduled_workout

Claude

review_plan_week

Claude

schedule_plan_week

Claude

set_athlete_constraint

Claude

set_athlete_data

Claude

set_athlete_goal

Claude

start_training_plan

Claude

update_training_plan

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/running-workout"><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/running-workout)