Go Garmin

go garmin

Garmin Connect API的Go客户端库和CLI。

安装

先决条件

• 转到1.25或更高版本(安装Go)
• $GOPATH/bin （通常 ~/go/bin)在你的路径中

安装CLI

go install github.com/llehouerou/go-garmin/cmd/garmin@latest

验证安装：

garmin --version

从源代码构建

git clone https://github.com/llehouerou/go-garmin.git
cd go-garmin
go build -o garmin ./cmd/garmin
./garmin --help

CLI使用情况

认证

# Login to Garmin Connect
garmin login -email=your@email.com -password=yourpassword

# Logout
garmin logout

命令

# Sleep data
garmin sleep [date]

# Wellness data
garmin wellness stress [date]
garmin wellness body-battery [date]
garmin wellness heart-rate [date]
garmin wellness spo2 [date]
garmin wellness respiration [date]
garmin wellness intensity-minutes [date]

# Activities
garmin activities list [--start=0] [--limit=20]
garmin activities get 
garmin activities types
garmin activities splits 
garmin activities weather 
garmin activities details 
garmin activities hr-zones 
garmin activities power-zones 
garmin activities exercise-sets 

# Weight and HRV
garmin weight daily [date]
garmin weight range --start=YYYY-MM-DD --end=YYYY-MM-DD
garmin hrv daily [date]
garmin hrv range --start=YYYY-MM-DD --end=YYYY-MM-DD

# Training metrics
garmin metrics readiness [date]
garmin metrics vo2max [date]
garmin metrics endurance [date]
garmin metrics hill [date]
garmin metrics training-status [date]
garmin metrics load-balance [date]
garmin metrics acclimation [date]
garmin metrics race-predictions [display-name]

# Fitness age
garmin fitnessage stats --start=YYYY-MM-DD --end=YYYY-MM-DD

# Fitness stats
garmin fitnessstats get [--start=YYYY-MM-DD] [--end=YYYY-MM-DD] [--aggregation=weekly] [--metrics=calories,distance,duration]
garmin fitnessstats activities [--start=YYYY-MM-DD] [--end=YYYY-MM-DD] [--activity_type=running] [--metrics=name,startLocal,activityType]

# Biometric data
garmin biometric lactate-threshold
garmin biometric ftp
garmin biometric hr-zones
garmin biometric power-weight [date]

# Devices
garmin devices list
garmin devices settings 

# User profile
garmin profile social
garmin profile settings
garmin profile display

# Workouts
garmin workouts list [--start=0] [--limit=20]
garmin workouts get 
garmin workouts create --file=workout.json
garmin workouts create --json='{"workoutName": "..."}'
cat workout.json | garmin workouts create
garmin workouts update  --file=workout.json
garmin workouts delete 
garmin workouts schedule  
garmin workouts unschedule 

# Exercise Library (for strength training workouts)
garmin exercises categories          # List all exercise categories
garmin exercises muscles             # List all muscle groups
garmin exercises equipment           # List all equipment types
garmin exercises list [--category=BENCH_PRESS] [--muscle=CHEST] [--equipment=DUMBBELL]
garmin exercises get   # Get exercise details

# Calendar (month is 0-indexed: January=0)
garmin calendar get --year=2026 [--month=0] [--day=28] [--start=1]

所有命令都输出JSON以便于解析。

MCP服务器（LLM集成）

CLI包括一个MCP（模型上下文协议）服务器，允许Claude等LLM助手访问您的Garmin数据。

先决条件

1. 安装CLI（请参阅 安装)
2. 登录一次以创建会话：

   garmin login -email=your@email.com -password=yourpassword

MCP服务器重用您的CLI会话，因此您只需登录一次。

克劳德代码

增添 ~/.claude.json （全球）或 .claude/settings.json （项目）：

{
  "mcpServers": {
    "garmin": {
      "command": "garmin",
      "args": ["mcp"]
    }
  }
}

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "garmin": {
      "command": "garmin",
      "args": ["mcp"]
    }
  }
}

光标

添加到光标设置（设置>MCP服务器）：

{
  "garmin": {
    "command": "garmin",
    "args": ["mcp"]
  }
}

故障排除

如果MCP服务器不工作：

1. 验证CLI是否在您的PATH中： which garmin
2. 检查您是否已登录： garmin sleep 应返回数据
3. 如果需要，请使用二进制文件的完整路径：

   {
     "mcpServers": {
       "garmin": {
         "command": "/full/path/to/garmin",
         "args": ["mcp"]
       }
     }
   }

可用工具

配置后，您可以向Claude提出以下问题：

• “我昨晚睡得怎么样？”
• “我今天的训练准备情况如何？”
• “显示我最近的活动”
• “我目前的最大摄氧量是多少？”
• “我今天的压力水平怎么样？”

MCP服务器公开了这些类别中的52个工具：

LLM动力训练创建

MCP集成支持对话式锻炼创建。让克劳德用自然语言创建训练：

跑步训练：

“创建一个45分钟的间歇训练，包括5分钟的热身、6x3分钟的阈值训练和2分钟的恢复，以及冷却”

“在心率2区为我进行90分钟的长跑锻炼”

力量训练计划：

“创建推压日训练：卧推4x8，顶推3x10，三头肌深蹲3x12，两组之间休息90秒”

“通过复合动作，针对胸部、背部和腿部进行全身力量训练”

“创建一个我可以在家做的仅哑铃上半身锻炼”

智能锻炼计划：

“看看我最近的活动，制定一个适合明天的恢复训练”

“根据我的训练负荷，为我的下一次训练提出建议并制定锻炼计划”

LLM使用锻炼库（1794个锻炼）查找有效的锻炼类别和名称，然后构建格式正确的锻炼，直接同步到您的Garmin设备。

对话示例

You: Create a chest and triceps workout with 3 exercises each, 4 sets of 10 reps

Claude: I'll create that workout for you. Let me first find the best exercises...

[Uses list_exercises with muscle=CHEST, then muscle=TRICEPS]

I've found good options. Creating your workout now...

[Uses create_workout with the structured JSON]

Done! I've created "Chest & Triceps" workout with:

Chest:
- Barbell Bench Press: 4x10
- Incline Dumbbell Press: 4x10
- Cable Flyes: 4x10

Triceps:
- Tricep Dips: 4x10
- Skull Crushers: 4x10
- Tricep Pushdowns: 4x10

Rest: 90 seconds between sets

The workout is now in your Garmin Connect account. Would you like me to schedule it?

锻炼类型参考

MCP工具支持所有Garmin锻炼类型：

图书馆使用情况

package main

import (
    "context"
    "fmt"
    "time"

    "github.com/llehouerou/go-garmin"
)

func main() {
    client := garmin.New(garmin.Options{})

    // Login
    err := client.Login(context.Background(), "email", "password")
    if err != nil {
        panic(err)
    }

    // Get today's sleep data
    sleep, err := client.Sleep.GetDaily(context.Background(), time.Now())
    if err != nil {
        panic(err)
    }

    fmt.Printf("Sleep score: %d\n", sleep.SleepScores.Overall.Value)
}

建筑

此项目使用 声明性端点注册表 系统。所有端点都是一次性定义的 endpoint/definitions/ 并自动生成：

• CLI命令（通过 endpoint.CLIGenerator)
• MCP工具（通过 endpoint.MCPGenerator)
• 验证规则（通过 endpoint.Validator)

看 CLAUDE.md 有关添加新端点的说明。

许可证

麻省理工学院