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 分