JustGains | Workouts & Nutrition Tracking

JustGains MCP サーバー

公式のJustGains MCP サーバーです。AI エージェントがワークアウトを作成して保存したり、ユーザーのトレーニング履歴や進捗を確認したり、JustGains のエクササイズライブラリを検索したり、ルートを計画したり、JustGains アカウントに食事や体重を記録したりできます。

実行方法は2つあります。ホスト型サーバーに接続する方法（インストール不要）と、独自のマシンでmcp-server/の stdio サーバーを実行する方法です。

ホスト型サーバーに接続する

エンドポイント	トランスポート	認証
https://justgains.com/connect/mcp	Streamable HTTP	OAuth 2.0

リモート MCP サーバーとして追加し、スマートフォンで使用している JustGains アカウントでブラウザーからサインインしてください。認証されていないリクエストは、WWW-Authenticate チャレンジを伴う 401 を返すため、MCP クライアントがサインインを開始します。認証には、PKCE S256、動的クライアント登録、および workouts progress profile スコープを使用する認可コードフローを利用します。API キーは不要で、このリポジトリに認証情報が保存されることもありません。

Claude Code：

claude mcp add --transport http justgains https://justgains.com/connect/mcp

mcpServers ファイルを読み込む Cursor などのクライアント：

{
  "mcpServers": {
    "justgains": {
      "url": "https://justgains.com/connect/mcp"
    }
  }
}

Grok Bot と Cursor プラグイン

このリポジトリは Grok Bot および Cursor 用の JustGains プラグイン（.cursor-plugin/plugin.json、mcp.json、.mcp.json）でもあり、同じサーバーとツールを提供する https://justgains.com/grok/mcp に接続します。Grok Bot では、Marketplace を開き、掲載されている場合は JustGains を見つけて Add を選択し、ブラウザーで JustGains の認証を完了してください。会話で @ を使って JustGains に言及すると利用できます。Marketplace への掲載には審査が必要です。このリポジトリを公開しても、掲載が承認されたことにはなりません。カスタム MCP サーバーが許可されている場合は、いずれかの URL を使ってリモート HTTPS サーバーを追加してください。チームのポリシーにより、カスタムサーバーが制限される場合があります。

ローカルで実行する（stdio）

mcp-server/は、公式 MCP SDK を使用して TypeScript で記述された stdio MCP サーバーです。ライブの JustGains ツールカタログを提供するため、スキーマは常にホスト型サーバーと一致します。また、各呼び出しを、サインイン中のユーザーとして JustGains ツール API 経由で実行します。Bunが必要です。

git clone https://github.com/JustGains/justgains-connector.git
cd justgains-connector/mcp-server
bun install
bun run login   # opens the JustGains sign-in in your browser

loginは、ループバックリダイレクトを使ってホスト型サーバーと同じ OAuth フローを実行し、ローテーションするリフレッシュトークンを~/.justgains/mcp-credentials.jsonに保存します。サインインしなくても、公開ツール（エクササイズ検索、ワークアウト生成、プレビュー）は引き続き利用できます。次に、クライアントをサーバーに接続します。

{
  "mcpServers": {
    "justgains": {
      "command": "bun",
      "args": ["run", "/path/to/justgains-connector/mcp-server/src/index.ts"]
    }
  }
}

変数	用途
JUSTGAINS_ACCESS_TOKEN	保存済みのサインインの代わりに、このアクセストークンを使用します。
JUSTGAINS_MEASUREMENT_SYSTEM	サマリーとカードで使用する単位です。imperialまたはmetricを指定します。未設定の場合は imperial が使用されます。
JUSTGAINS_CREDENTIALS	loginが認証情報を保存する場所です。

Dockerfile は同じ stdio サーバーをビルドして実行します。

ツール

「account」と記されたツールは、サインイン済みのユーザーが必要です。各ツールでは、読み取り専用、破壊的操作、オープンワールドに関するヒントが宣言されています。

ワークアウト

• generate_workout：自然言語でのリクエスト（「30分のダンベル・プッシュデイ」など）から、保存済みのワークアウトを作成します。アカウントなしで利用できます。
• show_workout：IDを指定して、ワークアウトのエクササイズ、セット、休憩時間を表示します。
• create_workout、update_workout（account）：正確なエクササイズ、セット数、回数、重量、セットの種類を指定して、ワークアウトを保存または編集します。
• search_exercises：名前、筋肉群、器具でエクササイズライブラリを検索し、書き込みツールで必要となる正確なエクササイズコードを返します。
• get_exercise_details（account）：1つのエクササイズの手順、対象筋肉、器具を表示します。

トレーニング履歴と進捗（account）

• get_my_workout_logs、get_workout_history：完了したワークアウトを、日付、エクササイズ、トップセットとともに表示します。
• get_my_exercise_history：1つのリフトで記録されたすべてのセットと自己ベストを表示します。
• get_my_top_exercises、get_progress、summarize_my_week、analyze_my_consistency：ランキング、ボリューム、週間サマリー、連続記録、トレーニング頻度を表示します。

プログラムとルート（account）

• search_workout_programs、get_workout_program：複数週にわたるプログラムを閲覧します。
• create_workout_program、set_my_program_engagement：プログラムを作成するか、開始または終了します。
• create_route：道路やトレイルに沿ったランニング、サイクリング、ウォーキング、ハイキングのルートを計画します。

食事と体重（account）

• log_my_food：1回の呼び出しで食事全体を記録します。分量が不明な場合は、推定値を明示します。過去の記録の修正にも対応します。
• get_my_food_diary、search_foods、remove_my_food：食事日記と1日のマクロ栄養素を確認し、食品カタログを検索し、記録を削除します。
• log_my_weight、get_my_weight_history：体重を記録し、推移を確認します。
• get_my_profile：ユーザーのプロフィール、単位、設定を確認します。

入力スキーマを含む最新のカタログはjustgains.com/mcp/tools、またはOpenAPI コントラクトで確認できます。

試してみる

• 「JustGainsを使って30分のダンベルワークアウトを作成し、アカウントに保存してください。」
• 「過去7日間に完了したJustGainsのワークアウトを表示してください。」
• 「今月、ベンチプレスがどのように変化したか確認してください。」
• 「朝食として、JustGainsに卵2個、トースト2枚、ミルク入りコーヒーを記録してください。」

生成されたワークアウトは、保存済みのプランです。返されたJustGainsのリンクを開くと、エクササイズを確認し、セッションを開始して、完了したセットを記録できます。プランを作成しても、完了したワークアウトとして記録されることはありません。食事の記録には、接続中のユーザーの食事日記が使用されます。分量の詳細が不明な場合や栄養価を推定した場合は、その旨が明示されます。モバイルアプリには、通常の同期を通じて変更が反映されます。

ツールの応答にはテキストとリンクが含まれるため、MCP Appsのカードに対応していないホストでもサーバーを利用できます。MCP Appsに対応したホストでは、操作可能なワークアウトカードと食事カードも表示されます。書き込みがタイムアウトした場合は、再試行する前に結果を確認してください。食事記録を再試行する場合、重複記録を避けるため、元のrequestIdを維持する必要があります。

検証

bun run verify（リポジトリのルートから実行）は、プラグインマニフェストと同梱パスを検証し、MCPの初期化と本番環境でのツール検出を実行し、公開エクササイズライブラリを検索し、OAuthのメタデータと登録を確認します。また、認証されていないリクエストで非公開プロフィールを読み取れないことを検証します。ワークアウトや食事の記録は作成しません。

リンク

• JustGains
• ClaudeでJustGainsを使う、ChatGPT、Grok Bot
• プライバシーポリシーと利用規約
• サポート：[email protected]

このリポジトリのMITライセンスは、このコネクタパッケージとstdioサーバーに適用され、ホスト型のJustGainsサービスには適用されません。