# JamsusMaximus/trainingpeaks-mcp [Health: Active]

**Category:** 🏃 Sports  
**Repository:** https://github.com/JamsusMaximus/trainingpeaks-mcp  
**GitHub Stars:** 156  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/jamsusmaximus-trainingpeaks-mcp

## Description
Query TrainingPeaks workouts, analyze CTL/ATL/TSB fitness metrics, and compare power/pace PRs through Claude Desktop.

## Tools
Capabilities this server exposes over MCP:

- **tp_get_workouts** — List workouts in a date range (max 90 days)
- **tp_get_workout** — Get full details for a single workout
- **tp_create_workout** — Create a workout with optional interval structure, auto-computed IF/TSS, and optional planned start time
- **tp_update_workout** — Update any field of an existing workout, including structured intervals and planned start time
- **tp_delete_workout** — Delete a workout
- **tp_copy_workout** — Copy a workout to a new date (preserves structure and planned fields)
- **tp_reorder_workouts** — Reorder workouts on a given day
- **tp_pair_workout** — Pair a completed workout with a planned workout (merges into one)
- **tp_unpair_workout** — Unpair a workout (splits into separate completed and planned workouts)
- **tp_validate_structure** — Validate interval structure without creating a workout
- **tp_get_workout_comments** — Get comments on a workout
- **tp_add_workout_comment** — Add a comment to a workout
- **tp_get_workout_note** — Get the private workout note for a workout
- **tp_set_workout_note** — Set or update the private workout note
- **tp_upload_workout_file** — Upload a FIT/TCX/GPX file to a workout
- **tp_download_workout_file** — Download a workout's device file
- **tp_delete_workout_file** — Delete an attached file from a workout
- **tp_analyze_workout** — Detailed analysis with time-series data, zones, and laps
- **tp_get_peaks** — Power PRs (5s-90min) and running PRs (400m-marathon)
- **tp_get_workout_prs** — PRs set during a specific session
- **tp_get_fitness** — CTL, ATL, and TSB trend (fitness, fatigue, form)
- **tp_get_weekly_summary** — Combined workouts + fitness for a week with totals
- **tp_get_atp** — Annual Training Plan - weekly TSS targets, periods, races
- **tp_get_athlete_settings** — Get FTP, thresholds, zones, profile
- **tp_update_ftp** — Update FTP for a sport's power set (bike default; preserves the set's calculation method)
- **tp_update_hr_zones** — Update HR threshold/max/resting for a sport (general/bike/run/swim), preserving the method
- **tp_update_speed_zones** — Update run/swim threshold pace, preserving the method
- **tp_create_zones** — Create a NEW per-sport zone set from scratch (choose the calculation method); errors if one already exists
- **tp_get_zone_methods** — List available zone-calculation methods per metric (power/HR/pace) with each method's zone count and labels
- **tp_update_nutrition** — Update daily planned calories
- **tp_get_pool_length_settings** — Get pool length options
- **tp_log_metrics** — Log weight, HRV, sleep, steps, SpO2, pulse, RMR, injury
- **tp_get_metrics** — Get health metrics for a date range
- **tp_get_nutrition** — Get nutrition data for a date range
- **tp_get_equipment** — List bikes and shoes with distances
- **tp_create_equipment** — Add a bike or shoe
- **tp_update_equipment** — Update equipment details, retire
- **tp_delete_equipment** — Delete equipment
- **tp_get_focus_event** — Get A-priority focus event with goals
- **tp_get_next_event** — Get nearest future event
- **tp_get_events** — List events in a date range
- **tp_create_event** — Add a race/event with priority (A/B/C) and CTL target
- **tp_update_event** — Update event details, attach workouts as legs (multisport)
- **tp_delete_event** — Delete an event
- **tp_create_note** — Create a calendar note
- **tp_list_notes** — List calendar notes for a date range
- **tp_get_note** — Get a calendar note by ID
- **tp_update_note** — Update title, description, date or visibility of a note
- **tp_delete_note** — Delete a calendar note
- **tp_get_note_comments** — List all comments on a note
- **tp_add_note_comment** — Add a comment to a note
- **tp_get_availability** — List unavailable/limited periods
- **tp_create_availability** — Mark dates as unavailable or limited
- **tp_delete_availability** — Remove availability entry
- **tp_get_libraries** — List workout library folders
- **tp_get_library_items** — List templates in a library
- **tp_get_library_item** — Get full template details including structure
- **tp_create_library** — Create a library folder
- **tp_delete_library** — Delete a library folder
- **tp_create_library_item** — Save a workout template
- **tp_update_library_item** — Edit a template
- **tp_schedule_library_workout** — Schedule a template to a calendar date, for one athlete or (coach accounts) several at once via `athletes
- **tp_search_exercises** — Search the built-in strength exercise library by name (offline)
- **tp_create_strength_workout** — Create a structured strength/gym workout (blocks of exercises with sets and parameters)
- **tp_get_strength_summary** — Get a strength workout's compliance summary (blocks/prescriptions/sets completed)
- **tp_get_strength_workouts** — List strength/gym workouts in a date range (they don't appear in `tp_get_workouts`)
- **tp_get_strength_workout** — Get a strength workout's full detail: blocks, exercises, sets, prescribed vs executed weights
- **tp_update_strength_workout** — Update a strength workout in place (replace/append blocks, retitle, mark complete) - preserves Garmin TSS and FIT files, so use this rather than delete-and-recreate on device-synced workouts
- **tp_delete_strength_workout** — Delete a strength workout by ID
- **tp_list_groups** — List the coach's athlete groups (TP tags)
- **tp_list_athletes_in_group** — List the athletes in one group, with names resolved from the roster
- **tp_create_group** — Create a new athlete group
- **tp_rename_group** — Rename an athlete group (default group cannot be renamed)
- **tp_delete_group** — Delete a group - the grouping only, athletes are not deleted
- **tp_add_athletes_to_group** — Add one or more athletes to a group
- **tp_remove_athletes_from_group** — Remove one or more athletes from a group
- **tp_list_training_plans** — List the coach's authored multi-week training plans
- **tp_get_training_plan** — Summary of one plan: weeks, per-week duration/distance, sport breakdown
- **tp_get_training_plan_workouts** — All workouts of a plan laid out by week/day
- **tp_apply_training_plan** — Apply a plan to an athlete's calendar from a start date (safe synthetic copy)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "trainingpeaks-mcp": {
    "command": "npx",
    "args": ["some-other-mcp"]
  }
}
```

## Documentation

## What JamsusMaximus/trainingpeaks-mcp does

JamsusMaximus/trainingpeaks-mcp MCP server exposes TrainingPeaks account and planning operations as MCP tools. It can retrieve workouts, inspect detailed workout data, create and edit sessions, copy workouts between dates, reorder a day's schedule, and pair or separate planned and completed workouts. Workout tools also cover comments, private notes, device files, and interval-structure validation.

The server goes beyond calendar CRUD. It provides workout analysis with time-series data, zones, and laps; power and running personal records; CTL, ATL, and TSB trends; weekly summaries; and Annual Training Plan data. Athlete-setting tools read and update FTP, heart-rate settings, pace settings, zones, nutrition targets, and pool-length options.

## How it works

JamsusMaximus/trainingpeaks-mcp uses the Model Context Protocol to make TrainingPeaks operations available to an AI client. The supplied material specifically identifies Claude Desktop as a client and also describes support for other AI assistants using MCP. Authentication uses a TrainingPeaks cookie. That cookie is stored in the operating system's keyring and is sent only to TrainingPeaks, according to the project documentation.

The server also includes account areas useful for broader training management: health metrics and nutrition, bikes and shoes, races and calendar notes, availability periods, workout libraries, structured strength workouts, coach athlete groups, and multi-week training plans. Strength workouts are handled separately from the regular workout listing, so clients should use the dedicated strength retrieval tools for those sessions.

## Setup and configuration

The provided material does not include a server installation command or package name. It does state that no approval for the official TrainingPeaks API is required and that users configure secure cookie authentication. The cookie setup is described as taking only a few minutes, with credentials kept in the system keyring rather than transmitted to an intermediary service.

Because no environment variable names, startup command, or client configuration block is supplied, installation details should be taken from the repository's current instructions rather than inferred here.

## Tools and capabilities

JamsusMaximus/trainingpeaks-mcp includes tools for:

- Reading, creating, updating, deleting, copying, and scheduling workouts.
- Building structured intervals and calculating intensity factor and training stress score for created workouts.
- Uploading, downloading, and deleting FIT, TCX, and GPX workout files.
- Comparing peaks and session PRs, reviewing fitness trends, and checking weekly totals against ATP targets.
- Updating FTP, heart-rate, and speed zones while preserving TrainingPeaks calculation methods.
- Logging and retrieving health metrics, nutrition, equipment, events, notes, and availability.
- Managing workout libraries, strength sessions, coach groups, and authored training plans.

## Limitations and notes

Workout date-range listing is limited to 90 days. Creating a new zone set fails when a set already exists for that sport. Zone setters cannot directly assign thresholds for speed or pace methods that derive values from distance/time tests; those configurations must be made through the TrainingPeaks interface. The server's group and training-plan tools are intended for coach accounts where applicable. Strength workouts do not appear in the general workout listing and require their dedicated tools.

## Getting started with this JamsusMaximus/trainingpeaks-mcp MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/jamsusmaximus-trainingpeaks-mcp/readme_