Hevy (unofficial)

hevy-mcp

Hevy 的非官方 MCP 服务。Hevy 是一款健身应用。你可以在 聊天中设计训练计划；AI 会直接在你的 Hevy 账户中创建训练计划，并分析 你记录的训练数据。需要 Hevy PRO API 密钥（hevy.com/settings?developer）。

使用方法

托管版（最简单 — claude.ai 网页版、移动端、桌面端）

在 claude.ai → Settings → Connectors 中添加自定义连接器：

https://hevy-coach.ajwallacemusic.workers.dev/mcp

系统会提示你输入 Hevy API 密钥；密钥会加密存储在你自己的 OAuth 授权中，且只会发送到 api.hevyapp.com。

Claude Desktop 一键安装

下载 hevy-mcp.mcpb， 双击，并在提示时粘贴密钥。

本地运行（Claude Code / Cursor / 任意 stdio 客户端）

claude mcp add hevy -e HEVY_API_KEY=<key> -- npx -y @almostjacked/hevy-mcp

自托管（免费，使用你自己的基础设施）

发布的包内含 worker，无需克隆：

mkdir hevy-worker && cd hevy-worker && npm init -y
npm install @almostjacked/hevy-mcp wrangler
cat > wrangler.jsonc <<'EOF'
{
  "name": "hevy-mcp",
  "main": "node_modules/@almostjacked/hevy-mcp/dist/worker.js",
  "compatibility_date": "2026-07-01",
  "compatibility_flags": ["nodejs_compat"]
}
EOF
npx wrangler deploy
npx wrangler secret put AUTH_TOKEN     # any long random string — becomes your Bearer token
npx wrangler secret put HEVY_API_KEY   # from hevy.com/settings?developer

将你的 worker URL（https://hevy-mcp.<your-subdomain>.workers.dev/mcp）添加到 支持自定义标头的客户端中 — 例如 Claude Code： claude mcp add --transport http hevy-selfhost <url> --header "Authorization: Bearer <token>"。 claude.ai 自定义连接器不支持自定义身份验证标头；如需在 claude.ai 中使用，请使用上文的 托管实例，或在 worker 前端接入 Cloudflare Access。

工具

工具	描述
search_exercises	按名称（模糊匹配）搜索用户的 Hevy 训练动作库。返回模板 ID、确切标题、类型、肌群和器械。
list_routine_folders	列出用户的训练计划文件夹（ID + 标题）。创建文件夹前请先检查；名称匹配时请复用现有文件夹。
create_routine_folder	创建训练计划文件夹；如果已存在标题完全相同的文件夹，则返回该文件夹（绝不重复创建）。
list_routines	列出用户现有的训练计划（ID、标题、folder_id、动作数量）。用于避免重复创建。
create_routine	创建训练计划（优先使用磅：weight_lb 按 2.5/5 lb 增量取整；RPE 合并到备注中；支持超级组；支持时长/距离目标）
get_workouts	获取用户最近记录的训练，按时间从新到旧排列，并以精简摘要形式显示：标题、日期、时长，以及每个动作的组数和最高负重组。查看单次训练的完整逐组详情，请使用 get_workout。
get_workout	获取一条已记录训练中的所有训练组（重量单位为 kg）。使用 get_workouts 返回的 ID。
get_workout_count	用户在 Hevy 中记录的训练总次数。
get_exercise_history	获取某项训练动作的历史训练组 + 估算 1RM（单位为 lb），支持完整历史记录和可选日期范围。
get_routine	完整获取一份训练计划（所有动作和训练组）。调用 update_routine 前务必先调用此工具，以便完整发送训练计划。
update_routine	替换现有训练计划。警告：此操作会覆盖训练计划——Hevy 会将其中的动作替换为你发送的内容，因此请先调用 get_routine，并包含所有要保留的动作。此处无法更改文件夹；时长/距离/自定义指标训练组目标可安全地往返处理。
get_training_summary	每周训练次数/训练量（lb）、各肌群训练组数、主要训练动作的 1RM 趋势

隐私政策

你的 Hevy API 密钥和训练数据只会传输至 api.hevyapp.com。 stdio/.mcpb 版本完全在你的设备上运行。托管实例只存储经过加密的 OAuth 授权；断开连接后，该授权即被撤销。 不会记录任何信息，也不会与第三方共享数据。