Tally Workout

Tally Workout MCP 服务

Tally Workout 远程 Model Context Protocol 服务的文档。Tally Workout 是一款免费的 iPhone 力量训练记录应用。你的 AI Agent 会读取训练历史，并在 Tally 应用中规划训练。你在健身房记录每组训练。下周，Agent 会根据你实际举起的重量来规划训练。你提出要求时，Agent 还可以记录、更改或删除已完成的训练；每项更改都可以在 7 天内撤销。

它适用于 Claude、Claude Code、Codex、ChatGPT、Muse、Hark、Perplexity、Dots，以及任何支持 OAuth 2.1 或 bearer token 的 MCP 客户端。

此仓库包含公开文档。该服务由官方开发，且不开源。它作为 Tally 后端的一部分运行。

端点

https://mcp.tallyworkout.app/api/mcp

• 传输方式： Streamable HTTP。不支持仅 SSE 模式。
• 身份验证，选项 1： OAuth 2.1，授权码 + PKCE（S256），公开客户端，动态客户端注册（RFC 7591）。作用域：workouts。
• 身份验证，选项 2： API 密钥，供不支持 OAuth 的客户端使用。在 Tally 应用的 Settings → API keys 中创建。将其作为 Authorization: Bearer tally_ct_… 发送。密钥权限分为只读、读取和规划，或完全访问。只有完全访问权限的密钥或 OAuth 连接才能更改已完成的训练。密钥不会过期。可在应用中撤销密钥。
• 发现： /.well-known/mcp-server、Agent 简介（llms.txt）。

按 Agent 设置

你需要安装 Tally iPhone 应用 并拥有一个 Tally 账户。每个链接都包含完整步骤。

Agent	身份验证	步骤
Claude（网页、桌面、手机）	OAuth	从 Claude 目录添加 Tally Workout。步骤
Claude Code	OAuth 或 API 密钥	运行 claude mcp add --scope user --transport http tally https://mcp.tallyworkout.app/api/mcp，然后输入 /mcp。步骤
Codex	API 密钥	在 ~/.codex/config.toml 中添加三行。步骤
ChatGPT	OAuth	开发者模式。Pro 仅支持读取。Business、Enterprise 和 Edu 可以规划训练。步骤
Muse	OAuth	客户端 ID 为 tally-muse。步骤
Hark	API 密钥	步骤
Perplexity	API 密钥	步骤
Dots	API 密钥	尚未测试。步骤
任何 MCP 客户端	OAuth 或 API 密钥	步骤

工具

21 个工具：10 个读取工具，11 个写入工具。

工具	类型	功能
get_training_context	读取	返回从今天起计划的训练日、重量单位，以及使用 historyWeeks 时的近期训练。
get_workout_history	读取	按时间从新到旧返回已记录的训练，逐组列出。每次训练都有一个稳定 ID。
get_workout	读取	按 ID 返回一条已记录的训练，逐组列出。
get_exercise_progress	读取	返回最近 365 天内最多 10 项运动的进度，包括顶组和估算的 1RM。
get_planned_workout	读取	完整返回某个计划训练日及其版本。
search_exercises	读取	将运动名称与用户近期练过的运动和 Tally 库进行匹配。
get_exercise	读取	按 ID 返回某项运动：肌肉、器械和说明，或用户自定义的运动。
get_training_summary	读取	返回最多 12 周的每周汇总：训练次数、组数、训练量、时长、各肌群训练量，以及未完成或跳过的计划。
get_saved_workouts	读取	返回用户已保存和收藏的训练模板。
get_workout_versions	读取	列出某次已完成训练可恢复的版本，也包括已删除的训练。
plan_workout_day	写入	创建或替换一个计划训练日。
plan_workout_range	写入	一次调用创建或替换最多 31 个计划训练日。
update_planned_workout	写入	修改某个计划训练日的部分内容：添加、移除或更改运动。
move_planned_workout	写入	将某个计划训练日移至一个空日期。
skip_planned_workout	写入	将某个计划训练日标记为已跳过，或恢复该计划。仅更改状态。
delete_planned_workout	写入	移除某个计划训练日并返回该计划，以便撤销。
log_workout	写入	将已完成的训练记录到用户的历史记录中。需要完全访问权限。
update_workout	写入	在当前版本上修改某次已完成的训练：字段、运动或组数。需要完全访问权限。
delete_workout	写入	删除当前版本的某次已完成训练。需要完全访问权限。
restore_workout	写入	在 7 天内将某次已完成训练的早期版本恢复为当前版本，也适用于已删除的训练。需要完全访问权限。
send_feedback	写入	将用户的消息发送给 Tally 团队。限制：每天最多 5 条消息。

规则

• 仅在用户提出要求时更改已完成的训练。 log_workout、update_workout、 delete_workout 和 restore_workout 需要完全访问密钥或 OAuth 连接。 update_workout 和 delete_workout 需要使用 get_workout 获取的训练 version 作为 expectedVersion。每次更改都会将之前的内容保留 7 天：get_workout_versions 会列出这些内容，restore_workout 可以将其恢复。除 restore_workout 外，所有工具都需要 当前 Tally 应用已登录手机。
• 某些日期受保护。 用户在应用中创建或编辑过的日期受保护。 除非用户要求覆盖，否则计划、更新、移动和删除工具都会跳过这些日期。
• 编辑时会检查版本。 如果某个日期或已完成的训练在 Agent 读取后发生变化，则不会写入任何内容，结果会报告冲突。
• 每位用户只能查看自己的数据。 OAuth 令牌和 API 密钥仅对单个账户有效。用户可以随时撤销它们。

链接

• 网站：https://tallyworkout.app
• 构建器参考：https://tallyworkout.app/connect/mcp
• 指南：https://tallyworkout.app/guides（例如，[使用 Claude 规划训练](https://tallyworkout.app/guides/plan-workouts-with-claude)）
• App Store：https://apps.apple.com/app/id6758911546
• 支持：[email protected]