OpenAthlete

io.github.whz14Published by GitHub account whz14v0.1.1Updated Oct 30, 2026

Unified Garmin and COROS training data, analysis, memory, and workout scheduling for AI agents

The publisher's own server: OpenAthlete

VerifiedSTDIODesktop onlyLocation & LifestyleKnowledge & MemoryData & Analytics

Overview

AI-generated overview

OpenAthlete unifies Garmin and COROS training data, load and recovery analysis, persistent memory and workout scheduling for AI agents.

What you can do
  • Get a one-page overview of recent training, unified load, recovery and the next race, with incremental sync when coverage is missing.
  • Query canonical activities, optionally with structure and interval detail.
  • Read training load trends (Edwards TRIMP and PMC) and recovery status such as resting heart rate and sleep HRV.
  • Trigger an incremental sync of activities and daily metrics.
  • Read the current in-progress plan and this week's log.
  • Read and write whitelisted Markdown memory files for cross-session context.
When to use it
Useful for athletes who want an AI assistant to discuss training, recovery, injury risk, race goals, nutrition and gear with their own Garmin or COROS history in context, and to schedule workouts back to the platform.
Requirements
Runs locally as a stdio process, started with uvx from the openathlete-mcp PyPI package; desktop only. Needs your own coding agent and model, plus your own Garmin and COROS account credentials entered locally during the guided setup. Network access is needed for installs, platform APIs and any cloud model.
Before you install
Data stays on your machine but not necessarily off it: platform sync calls their APIs and cloud models receive training, health and memory data in context. Enter account credentials locally, never in chat. Some capabilities use unofficial platform interfaces with rate-limit and breakage risk; COROS single sign-on can log you out of the app, and Garmin requires MFA to be disabled. Workouts are shown for confirmation before writing back. No medical diagnosis.

Installation

In SourceWeft

  1. Open OpenAthlete in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

OpenAthlete

让 coding agent 成为真正懂你的 AI 教练。

OpenAthlete 统一佳明（Garmin）与高驰（COROS）的数据和能力，并跨会话记住你的 训练历史、伤病、目标与偏好，让 AI 在完整的个人语境中理解和帮助你。

能帮你做什么

训练与恢复、伤病与风险、比赛目标与战术、营养与装备、数据分析与资料查询…… 都可以直接讨论。它不局限于一套固定命令：凡是你能想到、AI 能结合数据和工具 完成的运动相关需求，都可以先问它。

安装与开始

Kimi Code：在会话中输入：

text
/plugins install https://github.com/whz14/openathlete

Codex：在终端执行：

bash
codex plugin marketplace add https://github.com/whz14/openathlete && codex plugin add openathlete@openathlete

Claude Code 或其他 MCP 宿主：把这句话发给 agent：

text
使用 uvx openathlete-mcp 配置 OpenAthlete，并按 https://github.com/whz14/openathlete 的 AGENTS.md 完成初始化。

独立 MCP 包已发布到 PyPI 和 MCP Registry， 可由 agent 按需查询。

首次安装后按宿主要求重载或重启（Kimi Code 使用 /reload），然后另开一个与运动相关的 会话，即可进入初始化向导。环境、MCP、平台授权和偏好设置由 AI 引导或代办， 无需手动编写 MCP 配置。

之后不用背命令。直接问“你能做到什么”“你能不能……”“如何……”，它会说明 能做什么、需要哪些数据或授权，并带着你完成。

使用边界、隐私与风险

  • 需要你自己的 agent 与模型：OpenAthlete 不提供模型订阅或使用额度。分析能力 取决于所选模型，易用性取决于 coding agent、可用工具与数据完整度；AI 可能出错， 重要判断请复核。
  • 数据保存在本机，不等于数据不出机：安装更新会访问代码与依赖下载源，平台查询 和同步会访问对应 API，云端模型会收到随对话上下文发送的训练、健康和记忆数据。 账号凭据由你按向导在本机填写，不要贴进聊天。
  • 平台接口有边界：部分能力使用非官方接口，存在风控、限流和失效风险；数据是否 完整也取决于平台开放能力和你的账号。高驰采用单点登录，同步或授权期间打开高驰 App/网页可能互踢；佳明账号需关闭两步验证（MFA）。
  • 写入与健康边界：课表、计划等写回平台前会先展示内容并经你确认。AI 教练不提供 医疗诊断；出现严重伤病迹象请就医。

反馈与致谢

欢迎通过 Issues 提问题、需求或使用 场景，也欢迎按 贡献指南 提交改进。

感谢 XiaoSiHwang/garmin-sync-coros 提供的佳明→高驰同步基础，以及 garth 提供的 佳明通信能力。

本仓库自有代码以 MIT 发布。面向 coding agent 的完整文档见 AGENTS.md，产品与架构约定见 DESIGN.md。

Source: README.md at commit 5c59a08

Tools

9

get_overview

一页查看近期训练、统一负荷、恢复和下一赛事；必要时按覆盖状态增量同步。

Parametersdaysend_date

query_activities

查询 canonical 活动；detail=true 时附结构与细区间，不返回原始 FIT 或本地路径。

Parametersdayslimitsportdetailend_datestart_date

get_training_load

读取本地 Edwards TRIMP 与 PMC 趋势，并显示锚点和历史覆盖范围。

Parametersdaysend_date

get_recovery_status

读取指定日期的静息心率、睡眠 HRV 与缺失项；不生成虚假恢复评分。

Parametersdate

sync_now

立即对活动和日度指标各执行至多一个增量批次；长任务由调用方继续。

Takes no parameters.

get_current_plan

读取当前日期覆盖的唯一进行中计划及本周日志；v0 不读取平台日程。

Parametersdate

read_memory

读取一个白名单记忆文件，或以 list 枚举白名单档案；name/list 必须二选一。

Parameterslistname

write_memory

以模板校验、原子替换和可选哈希并发控制写入白名单 Markdown 记忆。

Parametersnamerequiredcontentrequiredallow_createexpected_sha256

create_workout

预览或确认创建单次课表；按 platform 路由 COROS 官方 MCP 或 Garmin API。

Parametersworkoutrequiredconfirm_token

Version history

2
  1. v0.1.1LatestOct 30, 2026
  2. v0.1.0Oct 30, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Openathlete integrations

OpenAthlete

org.openathleteOfficial publisher

OpenAthlete's hosted MCP server, published by openathlete.org; credential required; Streamable HTTP.

Streamable HTTPWeb executableAuth
Credential requiredNov 3, 2026