garmin-connect-mcp

概述

这个 MCP 服务器通过 22 个有组织的工具支持 LLM 与 Garmin Connect 交互，涵盖活动、健康指标、训练分析等功能。它支持 UV 和 Docker 安装方式，具有清晰的 MFA 认证支持。服务器提供 3 个持续上下文资源和 6 个常用查询的提示模板，是健身数据分析的全面解决方案。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• query-activities

  Query activities with pagination (by ID, date range, or specific date)

  试试:Show me my runs from the last 30 days试试:Get activities from January 1, 2023
• get-activity-details

  Get comprehensive activity details (splits, weather, HR zones, gear)

  试试:Get details for my half marathon yesterday试试:Show me metrics for my cycling activity last weekend
• compare-activities

  Compare 2-5 activities side-by-side

  试试:Compare my last three 10K runs试试:Show me differences between my two bike rides this week
• query-health-summary

  Query daily health summaries with pagination

  试试:What's my Body Battery level today?试试:Show me health data for the last week
• query-sleep-data

  Query sleep data with stages, scores, and HRV

  试试:How did I sleep last night?试试:Show my sleep quality for the past month
• analyze-training-period

  Analyze training over a time period with insights

  试试:Analyze my training over the past 30 days试试:What's my training trend for this month?
• get-user-profile

  Get comprehensive athlete profile with stats and PRs

  试试:Show me my fitness profile试试:What are my personal records?
• query-goals-and-records

  Query goals, personal records, and race predictions

  试试:What are my current fitness goals?试试:Show me my race predictions
• query-devices

  Query device information (with settings, solar data, alarms)

  试试:Show me my connected devices试试:What's the battery status of my watch?
• query-weight-data

  Query weight data for date or range

  试试:Show my weight for the last month试试:What's my current weight?
• manage-workouts

  Workout management (list, get, download, upload)

  试试:Show my saved workouts试试:Download my training plan
• log-health-data

  Log body composition, blood pressure, hydration

  试试:Log my weight for today试试:Update my blood pressure reading

可对比工具

安装

cd garmin-connect-mcp
uv sync

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

docker pull ghcr.io/eddmann/garmin-connect-mcp:latest

{
  "mcpServers": {
    "garmin": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ABSOLUTE/PATH/TO/garmin-connect-mcp",
        "garmin-connect-mcp"
      ]
    }
  }
}

FAQ

是否支持 MFA？

是的，服务器支持 MFA，在启用时会提示输入认证码。

令牌如何持久化？

OAuth 令牌保存在 ~/.garminconnect/ 目录中并自动刷新。使用 Docker 时，需将此目录作为卷挂载。

garmin-connect-mcp 对比