Back to Details

garmin-connect

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Garmin Connect Skill

Garmin Connect Skill

Overview

概述

Enables Claude to use Garmin Connect for fitness tracking including viewing activities, health metrics, training status, and data from Garmin wearables.
让Claude能够使用Garmin Connect进行健身追踪，包括查看活动记录、健康指标、训练状态以及Garmin可穿戴设备的数据。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/garmin-connect/install.sh | bash
Or manually:
bash
cp -r skills/garmin-connect ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/garmin-connect/install.sh | bash
或者手动安装：
bash
cp -r skills/garmin-connect ~/.canifi/skills/

Setup

设置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置：
bash
undefined

First, ensure canifi-env is installed:

首先，确保已安装canifi-env：

curl -sSL https://canifi.com/install.sh | bash

curl -sSL https://canifi.com/install.sh | bash

canifi-env set GARMIN_EMAIL "your-email@example.com" canifi-env set GARMIN_PASSWORD "your-password"
undefined
canifi-env set GARMIN_EMAIL "your-email@example.com" canifi-env set GARMIN_PASSWORD "your-password"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
您的凭据，由您掌控。 Canifi LifeOS尊重您的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果您不想与Claude Code共享凭据：
  1. 使用CDP模式完成浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录该服务
  3. Claude将使用您的已认证会话，且全程不会看到您的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果您愿意共享凭据，可以将其存储在本地：
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意：存储在canifi-env中的凭据仅能在您的本地机器上访问，绝不会被传输。

Capabilities

功能

  • View activity history
  • Check health metrics
  • Access training status
  • View sleep data
  • Check body battery
  • Access stress tracking
  • 查看活动历史记录
  • 查看健康指标
  • 访问训练状态
  • 查看睡眠数据
  • 查看身体电量（Body Battery）
  • 访问压力追踪数据

Usage Examples

使用示例

Example 1: Check Training Status

示例1：查看训练状态

User: "What's my Garmin training status?"
Claude: I'll check your training status.
1. Opening Garmin Connect via Playwright MCP
2. Navigating to training section
3. Viewing current status
4. Checking load and recovery
5. Summarizing recommendations
用户：“我的Garmin训练状态如何？”
Claude：我将为您查看训练状态。
1. 通过Playwright MCP打开Garmin Connect
2. 导航至训练板块
3. 查看当前状态
4. 检查训练负荷与恢复情况
5. 总结建议内容

Example 2: View Body Battery

示例2：查看身体电量

User: "What's my body battery level?"
Claude: I'll check your body battery.
1. Accessing health stats
2. Viewing body battery
3. Checking current level
4. Showing daily pattern
用户：“我的身体电量水平是多少？”
Claude：我将为您查看身体电量。
1. 访问健康统计数据
2. 查看身体电量
3. 检查当前水平
4. 展示每日变化规律

Example 3: Review Activities

示例3：查看活动记录

User: "Show me my activities from this week"
Claude: I'll review your activities.
1. Opening activities section
2. Filtering to this week
3. Listing all activities
4. Summarizing totals
用户：“展示我本周的活动记录”
Claude：我将为您查看活动记录。
1. 打开活动板块
2. 筛选本周数据
3. 列出所有活动
4. 总结总览信息

Authentication Flow

认证流程

  1. Navigate to connect.garmin.com via Playwright MCP
  2. Click "Sign In" and enter email
  3. Enter password
  4. Handle 2FA if required (via iMessage)
  5. Maintain session for data access
  1. 通过Playwright MCP导航至connect.garmin.com
  2. 点击“登录”并输入邮箱
  3. 输入密码
  4. 如需两步验证（2FA）则进行处理（通过iMessage）
  5. 维持会话以访问数据

Error Handling

错误处理

  • Login Failed: Retry up to 3 times, notify via iMessage
  • Session Expired: Re-authenticate automatically
  • Rate Limited: Implement exponential backoff
  • 2FA Required: Send iMessage notification
  • Sync Required: Check device connection
  • Data Delayed: Note sync timing
  • 登录失败：最多重试3次，通过iMessage通知用户
  • 会话过期：自动重新认证
  • 速率限制：实现指数退避机制
  • 需要2FA：发送iMessage通知
  • 需要同步：检查设备连接情况
  • 数据延迟：标注同步时间

Self-Improvement Instructions

自我改进说明

When Garmin Connect updates:
  1. Document new health metrics
  2. Update activity type support
  3. Track training features
  4. Log device compatibility changes
当Garmin Connect更新时：
  1. 记录新增的健康指标
  2. 更新支持的活动类型
  3. 追踪训练功能变化
  4. 记录设备兼容性变更

Notes

注意事项

  • Syncs from Garmin devices
  • Comprehensive health tracking
  • Training load analysis
  • Body battery unique feature
  • GPS-based activities
  • 与Garmin设备同步数据
  • 全面的健康追踪
  • 训练负荷分析
  • 独特的身体电量功能
  • 基于GPS的活动记录