Tally Workout

Tally Workout MCP サーバー

無料のiPhone向け筋力トレーニング記録アプリ、Tally WorkoutのリモートModel Context Protocolサーバーのドキュメントです。AI エージェントがトレーニング履歴を読み取り、Tally アプリでワークアウトを計画します。ジムでは各セットを記録します。翌週、エージェントは実際に挙げた重量をもとに計画を立てます。必要に応じて、完了したワークアウトの記録、変更、削除も行えます。また、各変更は7日以内であれば取り消せます。

Claude、Claude Code、Codex、ChatGPT、Muse、Hark、Perplexity、Dots、および OAuth 2.1 またはベアラートークンに対応するあらゆる MCP クライアントで動作します。

このリポジトリには公開ドキュメントが含まれています。サーバーは公式のクローズドソースです。Tally のバックエンドの一部として動作します。

エンドポイント

https://mcp.tallyworkout.app/api/mcp

• トランスポート： Streamable HTTP。SSE のみのモードには対応していません。
• 認証、方法1： OAuth 2.1、認可コード + PKCE（S256）、パブリッククライアント、動的クライアント登録（RFC 7591）。スコープ：workouts。
• 認証、方法2： OAuth に対応していないクライアント向けの API キー。Tally アプリの「設定」→「API キー」から作成します。Authorization: Bearer tally_ct_… として送信します。キーの権限は「読み取り専用」「読み取りと計画」「フルアクセス」のいずれかです。完了したワークアウトを変更できるのは、フルアクセスキーまたは OAuth 接続のみです。キーに有効期限はありません。アプリでキーを取り消せます。
• ディスカバリー： /.well-known/mcp-server、エージェント向け概要（llms.txt）。

エージェント別のセットアップ

Tally iPhone アプリとTally アカウントが必要です。各リンクに手順がすべて記載されています。

エージェント	認証	手順
Claude（ウェブ、デスクトップ、スマートフォン）	OAuth	Claude のディレクトリから Tally Workout を追加します。手順
Claude Code	OAuth または API キー	claude mcp add --scope user --transport http tally https://mcp.tallyworkout.app/api/mcp を実行してから、/mcp を実行します。手順
Codex	API キー	~/.codex/config.toml に3行を追加します。手順
ChatGPT	OAuth	開発者モードを使用します。Pro は読み取りのみです。Business、Enterprise、Edu では計画を立てられます。手順
Muse	OAuth	クライアント ID は tally-muse です。手順
Hark	API キー	手順
Perplexity	API キー	手順
Dots	API キー	まだテストされていません。手順
あらゆる MCP クライアント	OAuth または API キー	手順

ツール

21 個のツール：読み取り 10 個、書き込み 11 個。

ツール	種類	機能
get_training_context	読み取り	今日からの予定日、重量の単位、および historyWeeks を指定した場合は最近のワークアウトを返します。
get_workout_history	読み取り	記録済みのワークアウトを新しい順に、セットごとに返します。各ワークアウトには変更されない ID があります。
get_workout	読み取り	ID を指定して、記録済みのワークアウトを 1 件、セットごとに返します。
get_exercise_progress	読み取り	過去 365 日間の最大 10 種目の進捗を、トップセットと推定 1RM とともに返します。
get_planned_workout	読み取り	予定日の 1 日分を、バージョン情報とともにすべて返します。
search_exercises	読み取り	種目名をユーザーの最近の種目および Tally ライブラリと照合します。
get_exercise	読み取り	ID を指定して、筋肉、器具、手順を含む種目を 1 件、またはユーザーのカスタム種目を返します。
get_training_summary	読み取り	最大 12 週間分の週ごとの合計を返します。内容はワークアウト数、セット数、ボリューム、時間、筋肉ごとのボリューム、および未実施またはスキップされた予定です。
get_saved_workouts	読み取り	ユーザーが保存したワークアウトテンプレートとお気に入りのワークアウトテンプレートを返します。
get_workout_versions	読み取り	削除済みのものも含め、完了したワークアウト 1 件の復元可能なバージョンを一覧表示します。
plan_workout_day	書き込み	予定日の 1 日分を作成または置き換えます。
plan_workout_range	書き込み	1 回の呼び出しで最大 31 日分の予定日を作成または置き換えます。
update_planned_workout	書き込み	予定日の 1 日分について、種目の追加、削除、変更を行います。
move_planned_workout	書き込み	予定日の 1 日分を空いている日付に移動します。
skip_planned_workout	書き込み	予定日の 1 日分をスキップ済みにするか、元に戻します。変更されるのはステータスのみです。
delete_planned_workout	書き込み	予定日の 1 日分を削除して返すため、元に戻せます。
log_workout	書き込み	完了したワークアウトをユーザーの履歴に記録します。フルアクセスが必要です。
update_workout	書き込み	現在のバージョンの完了済みワークアウト 1 件について、フィールド、種目、セットを変更します。フルアクセスが必要です。
delete_workout	書き込み	現在のバージョンの完了済みワークアウト 1 件を削除します。フルアクセスが必要です。
restore_workout	書き込み	削除後も含め、7 日以内であれば、完了済みワークアウトの以前のバージョンを現在のバージョンに戻します。フルアクセスが必要です。
send_feedback	書き込み	ユーザーから Tally チームにメッセージを送信します。上限：1 日 5 件。

ルール

• ユーザーが依頼した場合にのみ、完了済みのワークアウトを変更します。 log_workout、update_workout、 delete_workout、restore_workout には、フルアクセスキーまたは OAuth 接続が必要です。 update_workout と delete_workout には、get_workout で取得したワークアウトの version を expectedVersion として指定する必要があります。変更前の内容は 7 日間保存され、get_workout_versions で一覧表示でき、restore_workout で元に戻せます。restore_workout を除くすべての操作には、 現在の Tally アプリをインストールしたスマートフォンが必要です。
• 一部の日付は保護されています。 ユーザーがアプリ内で作成または編集した日は保護されます。 ユーザーが上書きを依頼しない限り、予定、更新、移動、削除の各ツールはその日付をスキップします。
• 編集時にはバージョンを確認します。 エージェントが読み取った後に予定日または完了済みワークアウトが変更された場合、何も書き込まれず、結果に競合が報告されます。
• 各ユーザーが参照できるのは自分のデータのみです。 OAuth トークンと API キーは 1 つのアカウントに紐付けられます。ユーザーはいつでもそれらを無効にできます。

リンク

• サイト：https://tallyworkout.app
• ビルダーのリファレンス：https://tallyworkout.app/connect/mcp
• ガイド：https://tallyworkout.app/guides（例：[Claude でワークアウトを計画する](https://tallyworkout.app/guides/plan-workouts-with-claude)）
• App Store：https://apps.apple.com/app/id6758911546
• サポート：[email protected]