Trainingpeaks MCP

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.