GymLog

GymLog MCP 服务

GymLog 是一款力量训练日志，堪称“举铁界的 Letterboxd”。记录每组训练，追踪进度，规划下一次训练。

这是托管的 MCP 服务，并非开源项目。 GymLog 为 GymLog 用户运行此服务。此仓库仅包含文档：这里没有可供安装或运行的服务代码。将 AI 助手连接到下方的托管地址，并使用 GymLog 帐户登录即可。

https://getgymlog.web.app/mcp

此地址之后可能会迁移到独立域名。即便如此，此地址仍会继续有效。

目录

• 功能介绍
• 设置助手
  • Claude
  • ChatGPT
  • Grok
  • 其他 MCP 客户端
• 登录
• 权限
• 工具
• 限制
• 撤销和断开连接
• 隐私
• 已测试的平台
• 支持

功能介绍

连接后，助手可以读取你的 GymLog 训练日志：训练、任意动作的历史记录、个人纪录、从每周到每年的训练总量、模板、“接下来”计划，以及 GymLog 在训练开始时显示的简要信息（你上次的训练内容和今天可以尝试的重量）。如果你允许，它还可以创建模板、规划带目标重量的训练、记录、编辑或删除训练，以及导入它已有的训练历史记录。

例如：询问“我今天应该练什么？”，助手会使用 GymLog 为这次训练制定的计划来回答。

完整的工具参考文档请见 GymLog 网站：https://getgymlog.web.app/mcp-docs。 面向普通用户（非开发者）的设置帮助请见 https://getgymlog.web.app/ai。

设置助手

菜单可能会不时变化，自定义连接器可能需要付费套餐。如果某个步骤与实际情况不符，请在助手的设置中查找“连接器”或“MCP”。

Claude

1. 在网页版 Claude 或桌面应用中，打开 Settings › Connectors，然后选择 Add custom connector。
2. 将其命名为 GymLog，并粘贴地址：https://getgymlog.web.app/mcp
3. 选择 Connect，登录 GymLog 并允许访问。

在网页上添加的连接器也可在 Claude 移动应用中使用。

ChatGPT

1. 在网页版 ChatGPT 中，打开 Settings，找到连接器（或应用）部分，并在高级设置中启用 Developer mode。
2. 创建新的连接器，将其命名为 GymLog，粘贴地址，并选择 OAuth 作为登录方式： https://getgymlog.web.app/mcp
3. 登录 GymLog 并允许访问，然后在聊天中启用 GymLog。

ChatGPT 中的自定义连接器取决于你的套餐；对于工作帐户，还取决于工作区设置。

Grok

1. 在 grok.com 上，打开 Connectors，选择 New Connector，然后选择 Custom。
2. 粘贴地址：https://getgymlog.web.app/mcp
3. 登录 GymLog 并允许访问。

是否可用取决于你的 Grok 套餐。

其他 MCP 客户端

设置	值
地址	https://getgymlog.web.app/mcp
传输方式	Streamable HTTP
登录方式	使用 PKCE 的 OAuth 2.1。你的客户端会自行注册（动态客户端注册或客户端 ID 元数据文档），因此无需客户端 ID 或密钥。
元数据	https://getgymlog.web.app/.well-known/oauth-protected-resource/mcp
协议版本	2026-07-28、2025-11-25、2025-06-18

GymLog 网站列出了另外几个客户端的设置步骤，详见 https://getgymlog.web.app/ai#setup。这些客户端不在已测试的平台范围内。

还没有 GymLog 账号？让助手为你创建一个

改为添加这个地址，无需登录：

https://getgymlog.web.app/mcp?signup=1

助手会询问与 GymLog 应用注册时相同的信息（你的电子邮箱、他人看到的名称、唯一的 @handle、使用 kg 还是 lb，以及你是否同意注册声明：年满 18 岁、服务条款和隐私政策），并且只有在你同意后才会创建账号。随后 GymLog 会向你发送一封包含验证链接的电子邮件：你只需点击该链接。之后，所有工具都能在同一聊天中使用，无需重新连接。在你点击链接之前，只有三个注册工具可用；其他工具会回复“请先注册并验证电子邮件”，且不会执行任何操作。如果 3 天内无人点击链接，GymLog 会删除该账号。

登录

GymLog 使用 OAuth。连接时，助手会打开 GymLog 的连接页面，你可以在此：

1. 使用你在 GymLog 应用中使用的账号（Google、Apple 或电子邮件）登录，或在同一页面创建 GymLog 账号。应用并非必需。
2. 查看发起请求的助手，并选择允许它执行的操作（参见权限）。
3. 点击 允许。

在你点击“允许”之前，不会共享任何信息。助手会获得一个有效期为 1 小时的访问密钥，并使用续期密钥续期。如果助手 60 天内未续期，连接会自动结束。

如果你已经在使用 GymLog 应用，请开启 跨设备同步，这样助手就能看到这些训练记录。仅保存在手机上的训练记录对助手不可见。

权限

你可以在连接页面选择这些权限。连接始终包含查看训练记录的权限；每种修改权限都可以单独关闭，而 只读 会关闭所有修改权限。

范围	通俗说明
training:read	查看你的训练记录、训练历史、纪录、模板和计划
plans:write	创建和修改你的模板和计划，并为接下来的训练设置目标
workouts:write	为你记录训练，以及编辑或删除你的训练记录

工具

登录后可使用 25 个工具，注册地址上另有 3 个注册工具。“读取”工具不会更改任何内容。每个修改工具都会接收一个 clientRequestId，因此重试的请求只会执行一次。

Read (training:read)

Tool	Read or change	What it does
get_profile	Read	你的 GymLog 基本信息：单位（kg 或 lb）、是否使用手机应用、训练次数，以及手机上次同步的时间。
list_workouts	Read	你的训练记录，按时间从新到旧排列，可选择日期范围。
get_workout	Read	一次完整的训练：每个动作和每组训练。
get_exercise_history	Read	某个动作的历史记录：训练组数、顶组、最佳估算 1RM、训练量、进阶设置，以及 GymLog 对停滞 / 平台期的判定。
get_personal_records	Read	每个动作的个人纪录：最重的一组、最佳估算 1RM、最多重复次数和最大训练量。
get_training_summary	Read	包含指定日期的周、月、季度或年度汇总。
list_templates	Read	你的训练模板、每个模板最近一次使用的时间，以及其中的动作。
list_programs	Read	GymLog 内置的训练计划库。
search_exercises	Read	按名称或别名在 GymLog 动作库和你自定义的动作中查找动作。
get_exercise_guide	Read	动作的执行方法：步骤、参与的肌肉、器械类型和示范照片（附署名）。
list_equipment	Read	你的自定义器械和家庭健身房的杠铃片配置。不会返回健身房名称或位置。
list_planned_sessions	Read	你的 Up next 队列：包含目标重量和重复次数的计划训练。
get_todays_plan	Read	GymLog 在训练开始时逐字显示的简要计划：上次训练内容、今天的训练内容、热身和杠铃片配置。返回某个模板或计划训练的今日计划。
request_account_deletion	Change（仅发送电子邮件）	请求 GymLog 通过电子邮件向你发送删除账户的链接。此工具不会删除任何内容：只有你本人可以通过该链接删除账户。每分钟最多一个链接，每天最多 3 个。

Plans (plans:write)

Tool	Read or change	What it does
create_template	Change	创建训练模板：包含名称以及各动作的组数和重复次数。
update_template	Change	重命名模板或替换其中的动作列表。
remove_template	Change	从所有设备中移除模板。不会影响以往的训练记录。
update_exercise_settings	Change	更改 GymLog 对某个动作的进阶方式：重量增量、自动进阶、热身或重量规则。
plan_session	Change	将一项训练加入你的 Up next 列表，并为每组设置目标重量和重复次数。
remove_planned_session	Change	将一项计划训练从 Up next 中移除。

Workouts (workouts:write)

Tool	Read or change	What it does
log_workout	Change	添加一条已完成的训练记录。记录是私密的，不会发布给好友。
update_workout	Change	修改你的一条训练记录：日期、时间、时长、标题、动作或训练组。
remove_workout	Change	从所有设备中移除你的一条训练记录。助手必须说明要移除哪条记录，并征得你的同意。
import_workouts	Change	将助手已有的训练历史导入 GymLog。始终先进行试运行，并提供摘要供你查看。会跳过重复记录。
remove_import	Change	一次性移除某次导入中的所有训练记录。

Sign-up（仅限 https://getgymlog.web.app/mcp?signup=1，无需登录）

Tool	Read or change	What it does
get_started	Read	说明如何通过聊天创建 GymLog 账户。
create_account	Change	经你同意后创建 GymLog 账户，并通过电子邮件发送验证链接。
check_account_status	Read	显示你是否已点击该链接；点击后，同一聊天会自动登录。

每个工具的参数和完整说明：https://getgymlog.web.app/mcp-docs。

限制

对于你连接的每个助手，你的账户有以下限制：

• 每小时 60 次调用（其中 20 次可进行更改），每天 600 次调用。
• 导入有单独的限制：每天 120 次导入调用和 2 次新导入，每次调用最多 50 次训练，每次导入最多 3,000 次训练，每次导入最多添加 50 个新自定义练习。
• 免费账户只能记录或导入日期为今天及之前 30 天内的训练。更早的训练需要 GymLog Pro，可在 GymLog 应用中购买。导入中日期较早的行会被跳过，不会添加。
• 助手注册：每个网络每天最多创建 10 个新账户，每个电子邮件地址每天最多尝试 3 次。

连接助手免费。没有任何 GymLog MCP 工具会在 GymLog 端运行 AI。

撤销和断开连接

助手添加或更改的所有内容都会在 GymLog 中显示其名称。在 GymLog 应用中，前往设置 › 已连接的应用，然后选择该助手：

• 撤销其更改会还原该助手在过去 30 天内添加、更改或移除的内容，但不包括你之后亲自更改的内容。即使断开连接，撤销历史记录仍会保留 30 天。
• 撤销导入会一次性移除整个导入（助手也可以使用 remove_import 执行此操作）。
• 断开连接会立即停止其访问权限。此操作不会删除你的 GymLog 账户。

在助手中移除 GymLog 可能不会通知 GymLog，因此请在 GymLog 中断开连接以确保生效。没有应用？请给我们发送电子邮件（地址见隐私政策），或在 GymLog 网站上删除账户，这会断开所有助手的连接。

隐私

完整政策：https://getgymlog.web.app/privacy.html（第 3a 节介绍了 AI 助手）。

• **它可以查看的内容：**你的训练（日期、时间、时长、练习、组数、次数、重量、强度、组类型、有氧运动）、由这些数据计算得出的历史记录、纪录和摘要、你的训练模板、练习设置、自定义练习和器材、家庭健身房的杠铃片配置（仅重量和数量）、你的接下来计划以及你的单位设置。
• **它绝不会查看的内容：**你的备注、健身房或任何位置、照片、分享设置、动态、好友、评论或评价、你的姓名、@handle 或电子邮件、购买记录、Apple Health 或 Health Connect 数据，或你为他人记录的训练和组数。
• **它无法执行的操作：**分享任何内容、更改你的好友、个人资料或账户，或删除你的账户。
• **GymLog 会保留的内容：**连接信息（助手名称、你授权的内容、连接时间和最后使用时间，以及仅以哈希形式保存的密钥）；每条请求的记录（不包含训练数据），保留 90 天；保留 30 天的撤销历史记录；以及用于限制的请求计数器。
• **助手所属公司：**助手读取的内容会发送给运营该助手的公司，并受该公司自身的隐私政策约束；断开连接后，该公司仍可能保留这些内容。GymLog 不会将助手发送给它的内容用于广告、用户画像或 AI 训练。
• **删除：**断开连接会删除 GymLog 为该助手保存的请求记录。在应用或网站上删除 GymLog 账户会删除你的数据，并断开所有助手的连接。

这是一份训练日志，不构成医疗建议。

测试过的工具

这些测试由 GymLog 团队使用 GymLog 服务端代码（在 GymLog 的测试服务上运行，与上述地址使用相同代码）完成：

• MCP Inspector CLI 2.10.1，使用访问密钥：tools/list 和工具调用。
• **脚本化的 Streamable HTTP 客户端：**完整的 OAuth 流程（客户端注册、登录、同意每项权限、代码交换、密钥续期、撤销），以及在当前和较旧协议版本下调用 tools/list；在拥有数百个已同步训练记录的账户上测试每个读取工具，包括针对每个模板调用 get_todays_plan；测试计划和训练变更工具、先试运行再提交导入、remove_import、撤销和断开连接；以及从 create_account 到登录会话的助手注册流程，随后调用 request_account_deletion。
• **Grok (grok.com)：**通过 ?signup=1 进行实际注册连接。这项测试正是现在注册连接会从一开始就列出所有工具的原因，适用于不会刷新工具列表的助手。

上面关于 Claude 和 ChatGPT 的步骤是在 GymLog 网站上完成的，目前尚未列为已测试。

支持

发送邮件联系我们：邮箱地址见隐私政策（第 12 节“联系我们”）。设置帮助：https://getgymlog.web.app/ai。工具参考文档：https://getgymlog.web.app/mcp-docs。