MCP.so
ログイン

Garmin MCP Server

@Taxuspt

基本情報

カテゴリ

その他

ライセンス

MIT

トランスポート

stdio

作者

Taxuspt

投稿者

Alexandre Domingues

Garmin MCP Server について

MCP server to access Garmin data

接続前の確認

文書確認日:2026-10-25

適した用途

python-garminconnect 経由で Garmin データへアクセスするコミュニティサーバーです。初回認証と MCP サービスの起動は別の手順です。

設定と制限

まず garmin-mcp-auth を対話実行して認証情報を保存し、クライアントから garmin-mcp を起動します。認証用コマンドを起動コマンドにしないでください。期限切れ時は共有設定にパスワードを書かず、再認証してください。

リンク先の文書を確認した内容です。認証済みの実接続テストを意味しません。確認手順はご自身の環境で実行してください。

Garmin MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

Garmin MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

上のボタンで一時的なサンドボックスでこのサーバーを実行し、ツール一覧を取得できます。

概要

What is Garmin MCP?

This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients. It leverages the python-garminconnect library to access Garmin’s API.

How to use Garmin MCP?

Authenticate once by running uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp-auth. Then add the server to your MCP client (e.g., Claude Desktop) using the uvx command with the garmin-mcp tool. Optionally filter which of the 110+ tools are exposed via the GARMIN_ENABLED_TOOLS or GARMIN_DISABLED_TOOLS environment variables.

Key features of Garmin MCP

  • List and paginate recent activities
  • Edit activity name, type, description, and more
  • Access health metrics: steps, heart rate, sleep, stress
  • View body composition, training status, and readiness
  • Manage gear, workouts, and training plans
  • Download raw activity files (FIT, GPX, TCX, CSV)

Use cases of Garmin MCP

  • Query your weekly training load and recovery status from Garmin Connect
  • Download a FIT file for detailed power and cadence analysis
  • Create and schedule interval workouts without writing Garmin JSON
  • Monitor HRV trend, VO₂ max, and respiration rate over time
  • Manage gear and equipment mileage directly from an LLM chat

よくある質問

1

How do I authenticate for the first time?

Run `garmin-mcp-auth` in your terminal. It will prompt for your Garmin email, password, and an MFA code if enabled. OAuth tokens are saved to `~/.garminconnect` and are valid for approximately 6 months.

2

Can I limit which tools are available to the LLM?

Yes. Set `GARMIN_ENABLED_TOOLS` (comma‑separated allowlist) or `GARMIN_DISABLED_TOOLS` (denylist) as environment variables. Only matching tools will be registered, reducing context for the LLM.

3

What data is not accessible through this server?

A few endpoints are intentionally skipped: high‑volume activity details (GPS tracks), sport‑specific workout uploads, and destructive operations like deleting activities. These can be requested via GitHub issues.

4

Where are downloaded activity files saved?

Files go to the directory specified in the `download_activity_file` call argument, the `GARMIN_FIT_DOWNLOAD_DIR` environment variable, or a persisted directory set via `set_fit_download_dir`. On first run, no directory is configured and the tool will prompt you to set one.

5

Does the server require my Garmin credentials in the MCP config?

No. After the one‑time authentication step, tokens are stored locally. You can omit `GARMIN_EMAIL` and `GARMIN_PASSWORD` from the MCP client configuration.

コメント

「その他」の他のコンテンツ