Garmin Connect China MCP

中国リージョンのGarmin Connectアカウント向けの、ローカルで読み取り専用のMCPサーバーです。すべてのGarminクライアントはgarmin.cnにハードロックされています。API読み取りはhttps://connectapi.garmin.cnと、対応する中国のSSO/DI認証ホストに送信されます。

これはgarminconnectを通じてGarmin Connectの非公式コンシューマー向けWeb APIを使用しています。個人利用には適していますが、Garminがサービスを変更すると壊れる可能性があり、商用製品向けの承認されたGarmin Health APIの代替にはなりません。

要件

• Python 3.12+

• uv

• Garmin Connect 中国アカウント

Related MCP server: health-mcp

インストールと認証

このディレクトリから:

uv sync
uv run garmin-cn-auth

認証コマンドは、メールアドレス、パスワード、MFAをターミナルで直接要求します。パスワードとMFAコードがMCP引数になることはありません。更新可能なトークンは、デフォルトで~/.config/garmin-cn-mcp/に所有者のみの権限で保存されます。

そのトークンディレクトリはパスワードのように扱ってください。コピーされた可能性がある場合は、削除してGarminのアカウント/セキュリティ設定からアカウントアクセスを無効にしてください。

Codex / ChatGPTデスクトップに追加

Codex CLIを使用する場合:

codex mcp add garmin-cn -- \
  uv --directory /absolute/path/to/garmincn-mcp run garmin-cn-mcp

または、これを~/.codex/config.tomlに追加します:

[mcp_servers.garmin-cn]
command = "uv"
args = [
  "--directory",
  "/absolute/path/to/garmincn-mcp",
  "run",
  "garmin-cn-mcp",
]
startup_timeout_sec = 20
tool_timeout_sec = 60

ChatGPTデスクトップアプリ、Codex CLI、Codex IDE拡張機能は、同じCodexホストのMCP設定を共有します。ChatGPTデスクトップでは、設定 → MCPサーバー → サーバーを追加を開き、STDIOを選択して同じコマンドを使用することもできます。追加後、クライアントを再起動し、/mcpを使用してgarmin-cnが接続されていることを確認してください。

ChatGPT WebはローカルのCodex MCP設定を読み取りません。Webで使用するには、マルチユーザー認証とプライバシー設計を備えた別途ホストされたリモートMCP/プラグインが必要になります。これは意図的にこのプロジェクトの範囲外です。

ツール

• get_connection_status

• get_daily_summary

• get_sleep

• get_heart_rate

• get_hrv

• get_training_readiness

• get_morning_training_readiness

• get_body_battery

• list_activities

• get_activity_details

• get_activity_exercise_sets

• get_activity_supplementary

すべてのツールは読み取り専用で、非破壊的です。日付範囲は31日間、アクティビティリストは100件に制限されています。生のAPIパスやGarmin書き込みツールは公開されていません。

カスタムトークンストアパス

認証プロセスとMCPプロセスの両方にGARMIN_CN_TOKEN_STOREを設定するか、いずれかのコマンドに--token-storeを渡します。パスはGitリポジトリの外に置いてください。

開発チェック

uv sync --group dev
uv run pytest
uv run ruff check .
uv run mypy

テストは偽のプロバイダーを使用し、Garminに接続することはありません。