Garmin MCP 服务器

此模型上下文协议（MCP）服务器连接到 Garmin Connect，并向 Claude 和其他兼容 MCP 的客户端公开您的健身和健康数据。

功能

• 列出最近的活动
• 获取详细的活动信息
• 访问健康指标（步数、心率、睡眠）
• 查看身体组成数据

配置

1. 在新环境中安装所需的包：

uv sync

运行服务器

配置

您的 Garmin Connect 凭据从环境变量中读取：

• GARMIN_EMAIL：您的 Garmin Connect 电子邮件地址
• GARMIN_EMAIL_FILE：包含您的 Garmin Connect 电子邮件地址的文件路径
• GARMIN_PASSWORD：您的 Garmin Connect 密码
• GARMIN_PASSWORD_FILE：包含您的 Garmin Connect 密码的文件路径

基于文件的秘密在某些环境中很有用，例如在 Docker 容器内。请注意，您不能同时设置 GARMIN_EMAIL 和 GARMIN_EMAIL_FILE，同样也不能同时设置 GARMIN_PASSWORD 和 GARMIN_PASSWORD_FILE。

使用 Claude Desktop

1. 在 Claude Desktop 中创建配置：

编辑您的 Claude Desktop 配置文件：

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

添加此服务器配置：

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ],
      "env": {
        "GARMIN_EMAIL": "YOUR_GARMIN_EMAIL",
        "GARMIN_PASSWORD": "YOUR_GARMIN_PASSWORD"
      }
    }
  }
}

替换路径为您的服务器文件的绝对路径。

2. 重启 Claude Desktop

使用 MCP Inspector

为了测试，您可以从项目根目录使用 MCP Inspector：

npx @modelcontextprotocol/inspector uv run garmin-mcp

使用示例

一旦在 Claude 中连接后，您可以询问如下问题：

• “显示我最近的活动”
• “昨晚我的睡眠情况如何？”
• “我昨天走了多少步？”
• “显示我最近一次跑步的详细信息”

安全说明

故障排除

如果您遇到登录问题：

1. 确认您的凭据正确
2. 检查 Garmin Connect 是否需要额外验证
3. 确保 garminconnect 包是最新的

对于其他问题，请检查 Claude Desktop 日志：

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