最小限の Hevy MCP

エージェントがHevyのワークアウトデータを読み取り、Hevyの公開APIからワークアウトルーティンを作成できる、小規模なローカルModel Context Protocolサーバーです。

含まれるツール

• hevy_list_workouts

• hevy_get_workout

• hevy_list_routines

• hevy_get_routine

• hevy_search_exercises

• hevy_get_exercise_history

• hevy_create_workout

• hevy_create_routine

最初の6つの道具は読み取り専用です。hevy_create_workout と hevy_create_routine は接続されたHevyのアカウントに書き込み、非冪等な変更として注記されています。

hevy_create_routine は、今後のセッション用の再利用可能なプランを作成します。hevy_create_workout は、実際の開始・終了時刻とセット結果を使って完了済みのセッションを記録します。完了したワークアウトはデフォルトで非公開となり、記録されたパフォーマンス指標がないセットは拒否されます。

Related MCP server: hevy-mcp-server

要件

• Node.js 20 以降

• Hevy Pro アカウントと、https://hevy.com/settings?developer のAPIキー

インストールと検証

npm install
npm run check
npm run build
npm run smoke

ローカルで実行

export HEVY_API_KEY="your-key"
npm start

サーバーはstdin/stdoutで通信を行うため、直接実行すると静かに待機しているように見えます。MCPホストが起動して通信することを前提としています。

Codex に追加する

まずサーバーをビルドし、Codexを起動する環境で HEVY_API_KEY を利用できるようにしてください。その後、次を実行します。

codex mcp add hevy -- node /absolute/path/to/hevy-mcp/dist/index.js

サーバーを追加したら、Codexを再起動します。次のコマンドで設定を確認できます。

codex mcp list

APIキーをコミットしたり、ツールの引数として渡したりしないでください。MCPは HEVY_API_KEY からのみキーを読み、必須の api-key ヘッダーでHevyに送信します。

推奨される最初のリクエスト

直近5件のワークアウトを読み取って、頻度、種目の選択、明らかな進歩のパターンを要約してください。作成や更新は一切行わないでください。

エージェントにルーティンを作成させる場合は、hevy_create_routine を呼び出す前に、ルーティンの全体を見せて承認を得ることを必須にしてください。

完了したワークアウトを記録する場合は、実際のエクササイズ、セット結果、時刻をエージェントに与えてください。hevy_create_workout を呼び出す前に、完全なワークアウトを表示して承認を得ることを必須にしてください。エージェントに完了結果を捏造させてはいけません。