Hevy (unofficial)

io.github.almostjacked由 GitHub 账号 almostjacked 发布v0.1.0更新于 Oct 24, 2026

Create Hevy routines and analyze your training from chat. Unofficial; BYO Hevy PRO API key.

已验证Streamable HTTP可网页运行位置与生活数据与分析

概览

AI 生成的概览

非官方 Hevy MCP 服务器，让助手在你的 Hevy 账户中创建训练计划并分析已记录的训练。

可以做什么
  • 按名称搜索 Hevy 动作库，列出或创建训练计划文件夹
  • 列出已有计划、读取单个计划的完整内容、创建计划以及替换已有计划
  • 读取最近的训练记录、单次训练的逐组明细以及累计训练次数
  • 查看单个动作的历史组数与预估 1RM，并获取每周训练汇总（训练次数、容量、各肌群组数、主要动作 1RM 趋势）
适用场景
适合已经在 Hevy 记录训练、希望助手直接在账户中起草或调整训练计划，或根据历史数据总结训练容量、肌群均衡和力量趋势的用户。
运行要求
需要 Hevy PRO API 密钥（在 Hevy 开发者设置中获取）。可使用带 OAuth 登录的托管远程端点、一键安装的桌面包，或用 npx 运行本地 npm 包并设置 HEVY_API_KEY 环境变量。自托管需要 Cloudflare Workers 账户，并设置 AUTH_TOKEN 密钥用于 Bearer 认证。
安装前请注意
创建和更新计划会写入你的 Hevy 账户，且 update_routine 会用提交的内容完全替换计划中的动作，未包含的动作会丢失。API 密钥属于凭据；托管实例会接收该密钥并保存在你的 OAuth 授权中，本地和桌面版本则完全在本机运行。训练数据会发送至 Hevy 的 API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hevy (unofficial)，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.almostjacked%2Fhevy-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "hevy-unofficial": {
      "type": "http",
      "url": "https://hevy-coach.ajwallacemusic.workers.dev/mcp"
    }
  }
}

README

hevy-mcp

[CI] [npm] [MCP Registry] [Install in Cursor] [Install in VS Code]

Unofficial MCP server for Hevy. Design training programs in chat; your AI creates the routines directly in your Hevy account and analyzes your logged training. Requires a Hevy PRO API key (hevy.com/settings?developer).

Use it

Hosted (easiest — claude.ai web, mobile, desktop)

Add a custom connector in claude.ai → Settings → Connectors:

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

You'll be prompted for your Hevy API key; it's stored encrypted in your own OAuth grant and sent only to api.hevyapp.com.

Claude Desktop one-click

Download hevy-mcp.mcpb, double-click, paste your key when prompted.

Local (Claude Code / Cursor / any stdio client)

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

Self-host (free, your own infra)

The published package ships the worker — no clone needed:

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

Add your worker URL (https://hevy-mcp.<your-subdomain>.workers.dev/mcp) to clients that support custom headers — e.g. Claude Code: claude mcp add --transport http hevy-selfhost <url> --header "Authorization: Bearer <token>". claude.ai custom connectors don't support custom auth headers; for claude.ai use the hosted instance above, or front your worker with Cloudflare Access.

Tools

ToolDescription
search_exercisesSearch the user's Hevy exercise library by name (fuzzy). Returns template id, exact title, type, muscle group and equipment.
list_routine_foldersList the user's routine folders (id + title). Check this before creating a folder — reuse an existing one when the name matches.
create_routine_folderCreate a routine folder, or return the existing folder if one with this exact title already exists (never duplicates).
list_routinesList the user's existing routines (id, title, folder_id, exercise_count). Use to avoid creating duplicates.
create_routinecreate a routine (lb-first: weight_lb snaps to 2.5/5 lb increments; RPE folded into notes; supersets; duration/distance targets supported)
get_workoutsGet the user's most recent logged workouts, newest first, as compact summaries: title, date, duration, and per-exercise set count + top set. Use get_workout for full set-by-set detail of one workout.
get_workoutGet one logged workout with every set (weights in kg). Use the id from get_workouts.
get_workout_countTotal number of workouts the user has ever logged in Hevy.
get_exercise_historypast sets + estimated 1RM in lb for one exercise (full history, optional date range)
get_routineGet one routine in full (all exercises and sets). Always call this before update_routine so you can send back the complete routine.
update_routineReplace an existing routine. WARNING: this overwrites the routine — Hevy replaces its exercises with exactly what you send, so first call get_routine and include every exercise you want to keep. Folder cannot be changed here; duration/distance/custom-metric set targets round-trip safely.
get_training_summaryweekly sessions/volume (lb), sets per muscle group, top-lift 1RM trend

Privacy Policy

Your Hevy API key and training data pass through only to api.hevyapp.com. The stdio/.mcpb versions run entirely on your machine. The hosted instance stores nothing but your encrypted OAuth grant; disconnecting revokes it. Nothing is logged or shared with third parties.

来源：README.md，提交 0fd889e

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分