hevy-mcp

HevyフィットネスアプリAPI用のPython Model Context Protocol (MCP)サーバーです。Claude（またはMCP互換のAI）からHevyのワークアウトデータへのフルアクセスを提供し、ワークアウトの記録、ルーチンの管理、身体測定値の追跡などが行えます。

機能

• Hevy APIの全エンドポイントを網羅する25個のツール

• ビルド不要 — 純粋なPython製、インストールして実行するだけ

• フルCRUD — ワークアウト、ルーチン、エクササイズテンプレート、フォルダ、測定値、Webhookの作成・読み取り・更新

ツール

要件

• Python 3.10以上

• Hevy Proアカウント（APIアクセスに必要）

• hevy.com/settings?developerから取得したAPIキー

インストール

git clone https://github.com/YOUR_USERNAME/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」

• 「プッシュ/プル/レッグのルーチンを作成して」

• 「先月の体重の推移はどうなっている？」

• 「ルーマニアンデッドリフトのエクササイズテンプレートIDを探して」

• 「過去3ヶ月間のベンチプレスのセットをすべて見せて」

技術スタック

• FastMCP — Python MCPサーバーフレームワーク

• httpx — HTTPクライアント

• Hevy API — 公式REST API

ライセンス

MIT