Hevy Mcp

hevy-mcp

Hevy フィットネスアプリの API に対応した Python 製 Model Context Protocol（MCP） サーバーです。Claude（または MCP 対応の AI）から Hevy のワークアウトデータに完全にアクセスでき、ワークアウトの記録、ルーティンの管理、身体測定値の追跡などを行えます。

機能

• Hevy API のすべてのエンドポイントをカバーする 25 個のツール
• ビルド不要 — 純粋な Python 製で、インストールして実行するだけです
• 完全な CRUD — ワークアウト、ルーティン、エクササイズテンプレート、フォルダー、測定値、Webhook の作成、読み取り、更新が可能です

ツール

カテゴリー	ツール
ユーザー	get_user_info
ワークアウト	get_workouts、get_workout、get_workout_count、get_workout_events、create_workout、update_workout
ルーティン	get_routines、get_routine、create_routine、update_routine
ルーティンフォルダー	get_routine_folders、get_routine_folder、create_routine_folder
エクササイズテンプレート	get_exercise_templates、get_exercise_template、create_exercise_template
エクササイズ履歴	get_exercise_history
身体測定値	get_body_measurements、get_body_measurement、create_body_measurement、update_body_measurement
Webhook	get_webhooks、create_webhook、delete_webhook

必要条件

• Python 3.12+
• Hevy Pro アカウント（API アクセスに必要）
• hevy.com/settings?developer から取得した API キー

インストール

git clone https://github.com/srdjancodes/hevy-mcp
cd hevy-mcp
pip install -r requirements.txt

設定

Claude Desktop

claude_desktop_config.json に追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hevy": {
      "command": "python",
      "args": ["/absolute/path/to/hevy-mcp/server.py"],
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop を再起動します。チャット画面のツールアイコンの下に Hevy サーバーが表示されます。

環境変数

または、環境に HEVY_API_KEY を設定して、直接実行できます。

export HEVY_API_KEY=your-api-key-here
python server.py

使用例

接続したら、Claude に次のように尋ねることができます。

• 「直近 5 回のワークアウトを見せて」
• 「今日行った胸のワークアウトを記録して — ベンチプレス 3x8、100kg。インクラインダンベルプレス 3x10、30kg」
• 「プッシュ／プル／レッグのルーティンを作成して」
• 「過去 1 か月の体重の推移は？」
• 「ルーマニアンデッドリフトのエクササイズテンプレート ID を探して」
• 「過去 3 か月のベンチプレスのセットをすべて見せて」

技術スタック

• FastMCP — Python 製 MCP サーバーフレームワーク
• httpx — HTTP クライアント
• Hevy API — 公式 REST API

ライセンス

MIT