Garmin Connect MCP Server and API by Cotlet

Name: Garmin Connect MCP Server and API by Cotlet
Author: cotlet.dev

远程服务

cotlet.dev健康医疗0今天更新

代码仓库访问官网

关于 Garmin Connect MCP Server and API by Cotlet

Garmin Connect MCP Server and API by Cotlet 将 AI 客户端连接到 Garmin Connect 账户，用于健身与健康追踪。它通过托管 MCP 服务查看训练数据、创建和安排训练，也提供本地 stdio 服务及命令行工具。

主要功能

01查看活动和健康指标
02比较训练记录
03创建并安排训练
04通过工具读取 Garmin Connect 页面
05使用托管 MCP 或 stdio 连接
06通过命令行配置客户端

适用场景

01追踪睡眠和 HRV 的变化
02比较跑步配速与心率
03规划训练并将训练安排到日历

MCP 相关

托管的 Cotlet.dev 服务向 MCP 客户端提供 Garmin Connect 操作。本地 stdio 服务列出工具，并将调用转发到托管服务。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://cotlet.dev/mcp/v1/garmin/connect

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http dev-cotlet-garmin https://cotlet.dev/mcp/v1/garmin/connect

Cursor.cursor/mcp.json{"mcpServers":{"dev-cotlet-garmin":{"type":"http","url":"https://cotlet.dev/mcp/v1/garmin/connect"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"dev-cotlet-garmin":{"type":"http","url":"https://cotlet.dev/mcp/v1/garmin/connect"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"dev-cotlet-garmin":{"type":"http","url":"https://cotlet.dev/mcp/v1/garmin/connect"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"dev-cotlet-garmin":{"serverUrl":"https://cotlet.dev/mcp/v1/garmin/connect"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://cotlet.dev/mcp/v1/garmin/connect

Streamable HTTPhttps://cotlet.dev/mcp/v1/garmin需要授权

工具

详细介绍

如何将 Garmin Connect 连接到 Claude Code、ChatGPT 和任意 AI Agent

是的，Claude、ChatGPT 和其他 AI Agent 可以在你的 Garmin Connect 账户中运行。 Garmin 自带的 API 是只读的，面向开发者。Cotlet.dev 可将你自己的 Garmin Connect 账户连接到任意 AI Agent，让 AI 读取你的训练数据，并为你创建和安排训练计划。

你可以提出的请求

创建一个 10 km 节奏跑训练，并将它安排在我 Garmin 日历上的星期四。

过去 4 周里，我的睡眠和 HRV 有什么变化？

为我制定接下来 8 周的半程马拉松计划，并安排训练。

比较我最近三次长跑的配速、心率和步频。

今年我的 VO2 max 趋势如何？

2 分钟完成连接

在 https://cotlet.dev/app 获取 API 密钥，并将其导出为 COTLET_API_KEY。

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT

设置 → 应用 → 添加连接器 URL https://cotlet.dev/mcp/v1，然后使用 Cotlet.dev 登录。无需 API 密钥。

Cursor

将此仓库中的 .cursor/mcp.json 复制到你的项目中：

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

在本地运行（stdio）

这是一个真正的 MCP 服务。它通过 stdio 使用 MCP，无需任何密钥即可列出其 Garmin Connect 工具，并将每次工具调用转发到托管的 Cotlet.dev 服务。仍建议使用上面的托管 URL。如果你的客户端只能启动本地服务，请使用此方式。

{"mcpServers":{"garmin":{"command":"uvx","args":["garmin-cotlet-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

也可以使用 Docker：

docker build -t garmin-mcp .
docker run -i --rm -e COTLET_API_KEY garmin-mcp

工具：garmin_guide、garmin_status、garmin_open、garmin_read、garmin_click、garmin_type、garmin_close。如果没有 COTLET_API_KEY，工具调用会返回：“设置 COTLET_API_KEY。前往 https://cotlet.dev/app 获取密钥”。

命令行

需要 Python 3.10+，无需安装其他内容。从 PyPI 安装：

pip install garmin-cotlet-mcp        # or run it once: uvx garmin-cotlet-mcp connect
garmin-cotlet-mcp connect

或者直接从此仓库安装：

export COTLET_API_KEY="your-key"
python3 garmin_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 garmin_agent.py status    # is Garmin Connect ready in your Cotlet.dev account
python3 garmin_agent.py guide     # Garmin Connect screens and sign-in link
python3 garmin_agent.py read      # open Garmin Connect, read the page, close the browser
python3 garmin_agent.py tools     # list Cotlet.dev tools
python3 garmin_agent.py serve     # start the stdio MCP server (same as no argument)

Garmin Connect 用户常见问题

Garmin Connect 有 API 吗？

Garmin 提供面向开发者的个人只读 API 和商业版 Health API。两者都无法让 AI Agent 为你创建和安排训练。Cotlet.dev 可在你自己的 Garmin Connect 账户中运行，因此可以做到这一点。

如何将 Garmin 连接到 Claude AI？

将 Cotlet.dev 添加到 Claude（使用上面的 claude mcp add 命令，或在 Claude 应用中添加自定义连接器），在 Cotlet.dev Cloud Browser 中登录一次 Garmin Connect，然后向 Claude 询问你的训练情况。

如何将 Garmin Connect 连接到 ChatGPT？

在 ChatGPT 中将 Cotlet.dev 添加为应用（设置 → 应用，连接器 URL 为 https://cotlet.dev/mcp/v1），在 Cotlet.dev Cloud Browser 中登录一次 Garmin Connect，然后用日常语言向 ChatGPT 提问。无需代码，也无需 Garmin Connect API 密钥。

有 Garmin Connect MCP 服务吗？

Garmin Connect 没有官方 MCP 服务。Cotlet.dev 是一个托管的 MCP 服务，可全天候在 Garmin Connect 中为你运行，兼容 Claude、ChatGPT、Cursor、Codex、n8n、Make 和 Zapier。