# OpenAthlete

> OpenAthlete is a freemium MCP server for health and science. Let an AI agent read your endurance training and plan sessions into your calendar. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, self-hosted
- **Website:** https://docs.openathlete.org/docs/guides/ai-agents
- **Repository:** https://github.com/openathleteorg/openathlete
- **MCP Registry name:** org.openathlete/mcp
- **Categories:** health and science
- **Listing updated:** 2026-11-14

## About

Training data stays at the center here. After you connect an agent, it can read your zones, metrics, activities, calendar and training load. If you grant write access, it can plan and adapt sessions: building a block toward a race, reworking a week after illness, or comparing what you did with the plan. You choose what each agent may do and can revoke it in Settings.

Agents are told to call `get_athlete_context` first, which returns the date and time zone, metrics, zones, fitness and form, four weeks of training, upcoming races and injuries. `plan_sessions` can add up to 60 trainings with structured workouts in one go and saves all or none. Done sessions and recorded activities are never deleted. Workouts use plain units: seconds, paces such as 4:35 per km, your own zones or percentages of FTP or maximum heart rate. Planned workouts reach Garmin, COROS and Suunto watches like ones you build yourself.

Claude, ChatGPT and Cursor sign in with OAuth; other clients use a personal token you scope and expire. The hosted server is `https://api.openathlete.org/mcp`, and self-hosted instances use their own `/api/mcp` path. Three prompts cover building a plan, adapting it and reviewing a week.

## Features

- **Athlete context:** One call returns metrics, zones, fitness, recent training, races and injuries.
- **Calendar planning:** Adds, moves, copies and repeats sessions, races and notes.
- **Training load view:** Shows weekly load with projected fitness, fatigue and form.
- **Scoped permissions:** Read and write access are separate, and agents can be revoked in Settings.
- **Watch delivery:** Planned workouts reach Garmin, COROS and Suunto watches.
- **Coach support:** Coaches can list the athletes they coach.

## Good for

- Build a 12-week plan toward a marathon
- Rework a training week after illness or injury
- Review a finished week against the plan
- Log metrics and update a zone after a test
- Schedule a repeating workout every few weeks

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://api.openathlete.org/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.openathlete.org/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.openathlete.org/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.openathlete.org/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.openathlete.org/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.openathlete.org/mcp"
    }
  }
}
```

## Tools

- `get_athlete_context`: Date, time zone, metrics, zones, fitness and form, recent training, races and injuries.
- `get_calendar`: Planned sessions, races, notes, activities and periods between two dates.
- `get_session`: A session's structured workout.
- `get_activity`: An activity's laps and post-activity answers.
- `get_activities`: Training history.
- `get_training_volume`: Weekly volume per sport.
- `get_training_load`: Weekly load with projected fitness, fatigue and form.
- `get_metrics`: Metric history such as weight, resting HR, HRV and sleep.
- `get_records`: Best efforts.
- `list_workout_templates`: The workout library.
- `list_athletes`: Athletes a coach coaches.
- `plan_sessions`: Adds up to 60 sessions, races and notes atomically.
- `update_session`: Changes a session, race or note.
- `move_sessions`: Moves sessions by days.
- `copy_sessions`: Copies sessions.
- `repeat_session`: Repeats a session every few weeks.
- `delete_sessions`: Deletes planned sessions.
- `create_period`: Creates a training block or period.
- `update_period`: Updates a period.
- `delete_period`: Deletes a period.
- `log_metrics`: Records measurements.
- `update_training_zone`: Changes a zone after a test.

## FAQ

### Can the agent delete my recorded activities?

No. Done sessions and recorded activities are never deleted by delete_sessions.

### How do I connect a client without OAuth?

Create a personal token in Settings, choose its permissions and expiry, and send it as a Bearer Authorization header.

### Can I self-host it?

Yes. A self-hosted instance exposes the server at its own domain under /api/mcp.

### What does it cost?

OpenAthlete describes itself as free; an optional Supporter plan is €5 a month or €50 a year.

### Is OpenAthlete free?

OpenAthlete has a free plan, with paid plans for more usage or features.

### How do I add OpenAthlete to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.openathlete.org/mcp

### What are the best alternatives to OpenAthlete?

The closest alternatives to OpenAthlete are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/openathlete-2
