XERT

You run a Model Context Protocol (MCP) server that connects Claude to the XERT API, providing you with access to your fitness signature, training load, workouts, and activities. This server makes it easy to ask Claude for up-to-date XERT data and receive actionable insights right in your workspace.

How to use

You interact with the XERT MCP server through your MCP client (such as Claude Desktop). Start by authenticating with XERT, then run the MCP server and connect it to Claude. Once connected, you can ask for your current fitness metrics, review your training status, fetch or export workouts, browse activities, and upload FIT files for analysis. The server handles token renewal automatically, so you can focus on your training data rather than authentication hiccups.

Key capabilities you can use include checking your fitness signature (FTP, LTP, HIE, Peak Power), reviewing training status and load, obtaining the AI-powered Workout of the Day, listing and exporting workouts as ZWO or ERG, browsing activities with XSS and MPA data, and uploading FIT files for analysis.

How to install

Prerequisites: Node.js 18 or later and a XERT account (free or premium). Then follow these steps to set up the MCP server and connect Claude.

# 1. Clone the MCP server repository
git clone https://github.com/Milofax/xert-mcp.git
cd xert-mcp

# 2. Install dependencies
npm install

# 3. Authenticate with XERT and generate tokens
npm run setup-auth
# Enter your XERT email and password when prompted. Tokens will be saved to .env

# 4. Build the project
npm run build

Configuration

Configure Claude Desktop to load the MCP server. You will provide a stdio MCP entry that runs the local server binary.

{
  "mcpServers": {
    "xert": {
      "command": "node",
      "args": ["/path/to/xert-mcp/dist/server.js"]
    }
  }
}
```}]} ,{

Security and tokens

Tokens are managed automatically. Access tokens expire after 7 days; refresh tokens expire after 6 months. Tokens are stored locally and refreshed as needed. If authentication fails completely, re-run the setup to re-authenticate.

When using MCP funnels or similar tools, tokens from the local token store take precedence over environment variables to ensure you always use refreshed tokens.

Docker deployment (alternative)

You can run the MCP server via Docker. Build the image, authenticate locally to generate tokens, and then run the container with the required environment variables.

# 1. Build the image
docker build -t xert-mcp .

# 2. Authenticate locally to generate tokens (produces xert-tokens.json)
npm install
npm run setup-auth

{
  "mcpServers": {
    "xert": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "XERT_ACCESS_TOKEN",
        "-e", "XERT_REFRESH_TOKEN",
        "xert-mcp"
      ],
      "env": {
        "XERT_ACCESS_TOKEN": "your-access-token-from-xert-tokens.json",
        "XERT_REFRESH_TOKEN": "your-refresh-token-from-xert-tokens.json"
      }
    }
  }
}
```}]}] },

Available Tools and Endpoints

The MCP server provides a set of tools to interact with XERT data through Claude. These tools are designed to fetch, view, and export data, as well as upload new data for analysis.

• xert-get-training-info — Retrieve fitness signature, training status, load, and Workout of the Day.
• xert-list-workouts — List all saved workouts.
• xert-get-workout — Get detailed details for a specific workout.
• xert-download-workout — Export a workout as ZWO or ERG.
• xert-list-activities — List activities within a time range.
• xert-get-activity — Get details for an activity, including XSS metrics.
• xert-upload-fit — Upload a FIT file for analysis.

Notes

If you need to restart or update the server, rebuild and start the production server as needed. Tokens should be refreshed automatically, but you can re-run the setup-auth command if you encounter authentication issues.

Available tools

xert-get-training-info

Retrieve your fitness signature, training status, training load, and Workout of the Day (WOTD) information.

xert-list-workouts

List all saved workouts with details and IDs for reference or export.

xert-get-workout

Fetch detailed intervals for a specific workout.

xert-download-workout

Export a workout as a ZWO or ERG file for use in compatible apps.

xert-list-activities

List activities within a specified time range, including XSS metrics.

xert-get-activity

Get detailed activity data with XSS metrics and MPA information.

xert-upload-fit

Upload a FIT file for analysis and to generate insights.