garth-mcp-server

基于 garth 的 Garmin Connect MCP 服务器。

使用方法

安装

{
  "mcpServers": {
    "Garth - Garmin Connect": {
      "command": "uvx",
      "args": [
        "garth-mcp-server"
      ],
      "env": {
        "GARTH_TOKEN": "<`uvx garth login` 命令的输出结果>"
      }
    }
  }
}

确保 uvx 命令的路径是完全限定的，因为 MCP 不使用与您的 shell 相同的 PATH。在 macOS 上，通常是 /Users/{user}/.local/bin/uvx。

工具

健康与福祉（使用 Garth 数据类）

• user_profile - 获取用户资料信息
• user_settings - 获取用户设置和偏好
• nightly_sleep - 获取详细的睡眠数据，可选包括运动数据
• daily_sleep - 获取每日睡眠概要数据
• daily_stress / weekly_stress - 获取压力数据
• daily_intensity_minutes / weekly_intensity_minutes - 获取强度分钟数
• daily_body_battery - 获取身体电量数据
• daily_hydration - 获取补水数据
• daily_steps / weekly_steps - 获取步数数据
• daily_hrv / hrv_data - 获取心率变异性数据

活动（使用 Garmin Connect API）

• get_activities - 获取活动列表，可选带有过滤器
• get_activities_by_date - 获取特定日期的活动
• get_activity_details - 获取详细的活动信息
• get_activity_splits - 获取活动分段数据
• get_activity_weather - 获取活动天气数据

额外健康数据（使用 Garmin Connect API）

• get_body_composition - 获取身体组成数据
• get_respiration_data - 获取呼吸数据
• get_spo2_data - 获取 SpO2（血氧）数据
• get_blood_pressure - 获取血压读数

设备与装备（使用 Garmin Connect API）

• get_devices - 获取连接设备
• get_device_settings - 获取设备设置
• get_gear - 获取装备信息
• get_gear_stats - 获取装备使用统计

实用工具

• monthly_activity_summary - 获取月度活动概览
• snapshot - 获取指定日期范围的数据快照
• get_connectapi_endpoint - 直接访问任何 Garmin Connect API 端点