Garmin MCP サーバー

このモデルコンテキストプロトコル (MCP) サーバーは Garmin Connect に接続し、フィットネスと健康のデータを Claude やその他の MCP 対応クライアントに公開します。

特徴

最近のアクティビティを一覧表示する
詳細なアクティビティ情報を取得する
健康指標（歩数、心拍数、睡眠）にアクセス
体組成データを表示する

設定

新しい環境に必要なパッケージをインストールします。

virtualenv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Garmin の認証情報を使用して、プロジェクトルートに.envファイルを作成します。

GARMIN_EMAIL=your.email@example.com
GARMIN_PASSWORD=your-password

サーバーの実行

クロード・デスクトップ

Claude Desktop で構成を作成します。

Claude Desktop 構成ファイルを編集します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

次のサーバー構成を追加します。

{
  "mcpServers": {
    "garmin": {
      "command": "python", // if you created a new environment this should be "<root_folder>/.venv/bin/python"
      "args": ["<path to>/garmin_mcp/garmin_mcp_server.py"]
    }
  }
}

パスをサーバーファイルへの絶対パスに置き換えます。

Claudeデスクトップを再起動します

MCPインスペクターを使用

テストには、MCP Inspector を使用できます。

npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py

使用例

Claude に接続すると、次のような質問をすることができます。

「最近のアクティビティを表示」
「昨晩の睡眠はどうだった？」
「昨日は何歩歩いた？」
「最新の実行の詳細を表示」

セキュリティに関する注意事項

このサーバーでは、 .envファイルに Garmin Connect の認証情報が必要です。このファイルは安全に保管し、リポジトリにコミットしないでください。

トラブルシューティング

ログインの問題が発生した場合:

.envファイル内の資格情報が正しいことを確認してください
Garmin Connectで追加の認証が必要かどうかを確認する
GarminConnectパッケージが最新であることを確認する

その他の問題については、次の Claude Desktop ログを確認してください。

macOS: ~/Library/Logs/Claude/mcp-server-garmin.log
Windows: %APPDATA%\Claude\logs\mcp-server-garmin.log

Garmin MCP Server

Integrations