TrainingPeaks MCP Server
Connect TrainingPeaks to Claude and other AI assistants via the Model Context Protocol (MCP). Query workouts, build structured intervals, manage your calendar, track fitness trends, and control your training through natural conversation.
No API approval required. The official Training Peaks API is approval-gated, but this server uses secure cookie authentication that any user can set up in minutes. Your cookie is stored in your system keyring, never transmitted anywhere except to TrainingPeaks.
What You Can Do
Ask your AI assistant things like:
- "Build me a 4x8min threshold session for Tuesday with warm-up and cool-down"
- "Schedule my mobility session for April 14, 2026 at 16:45"
- "Compare my FTP progression this year vs last year"
- "Copy last week's long ride to this Saturday"
- "Log my weight at 74.5kg and sleep at 7.5 hours"
- "What's my weekly TSS so far? Am I on track for my ATP target?"
- "Show my race calendar and how many weeks until my A race"
- "Set my FTP to 310 and update my power zones"
- "Add a calendar note for next Monday: rest day, travel"
Tools (78)
Workouts
| Tool | Description |
|---|---|
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 |
Analysis & Performance
| Tool | Description |
|---|---|
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 |
Athlete Settings
| Tool | Description |
|---|---|
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 |
Zone updates — how they work & one limitation. The zone setters target the
right per-sport zone set (by workoutTypeId) and recompute the bands with
TrainingPeaks' own zone calculator (the same call the web UI's Calculate
makes), so the athlete's calculation method (%LTHR, Karvonen, Andy Coggan, …) is
honoured exactly. They update a threshold (FTP / LTHR / threshold pace).
Limitation — test-based (Distance/Time) methods. A zone set whose method derives its threshold from a test result (Speed/Pace Distance / Time) cannot have a threshold set directly — there is no stable value to set. These tools detect that case and return
TEST_BASED_METHOD(writing nothing) rather than storing a wrong threshold; configure such a set via a test in the TrainingPeaks UI. This is deliberate: the connector owns threshold-anchored zones; test-protocol setup stays in the UI.
Health Metrics
| Tool | Description |
|---|---|
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 |
Equipment
| Tool | Description |
|---|---|
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 |
Events & Calendar
| Tool | Description |
|---|---|
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 |
Workout Library
| Tool | Description |
|---|---|
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 |
Strength Workouts
| Tool | Description |
|---|---|
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_delete_strength_workout |
Delete a strength workout by ID |
Athlete Groups (coach accounts)
| Tool | Description |
|---|---|
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 |
Reference & Auth
| Tool | Description |
|---|---|
tp_get_workout_types |
List all sport types and subtypes with IDs |
tp_get_profile |
Get athlete profile |
tp_auth_status |
Check authentication status |
tp_list_athletes |
List athletes (coach accounts) |
tp_refresh_auth |
Re-authenticate from browser cookie |
Setup Options
Option A: Auto-Setup with Claude Code
If you have Claude Code, paste this prompt:
Set up the TrainingPeaks MCP server from https://github.com/JamsusMaximus/trainingpeaks-mcp - clone it, create a venv, install it, then walk me through getting my TrainingPeaks cookie from my browser and run tp-mcp auth. Finally, add it to my Claude Desktop config.
Claude will handle the installation and guide you through authentication step-by-step.
Option B: Manual Setup
Step 1: Install
git clone https://github.com/JamsusMaximus/trainingpeaks-mcp.git
cd trainingpeaks-mcp
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .
Step 2: Authenticate
Option A: Auto-extract from browser (easiest)
If you're logged into TrainingPeaks in your browser:
pip install tp-mcp[browser] # One-time: install browser support
tp-mcp auth --from-browser chrome # Or: firefox, safari, edge, auto
macOS note: You may see security prompts for Keychain or Full Disk Access. This is normal - browser cookies are encrypted and require permission to read.
Option B: Manual cookie entry
- Log into app.trainingpeaks.com
- Open DevTools (
F12) -> Application tab -> **Cookie