Skip to content
MCP server

OpenAthlete

Let an AI agent read your endurance training and plan sessions into your calendar

Pricing
Freemium
Platforms
Web, API, self-hosted
Runs
Remotely
Version
1.3.0
Listing updated
3 days ago

About OpenAthlete

OpenAthlete is a freemium MCP server for health and science. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.openathlete.org/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://api.openathlete.org/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (22)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Free on hosted and self-hosted; optional Supporter at 5 EUR/month or 50 EUR/year

Prices change. Check docs.openathlete.org before you buy.

OpenAthlete 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 to OpenAthlete

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science