MCP.so
登录

Garmin MCP Server

@Taxuspt

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

Taxuspt

提交者

Alexandre Domingues

关于 Garmin MCP Server

MCP server to access Garmin data

连接前先了解

文档核对日期:2026-10-25

适合什么场景

这个社区服务通过 python-garminconnect 访问 Garmin 数据。首次账户认证与启动 MCP 服务是两个不同步骤。

配置与限制

先交互运行 garmin-mcp-auth 保存本地凭据,再在 MCP 客户端启动 garmin-mcp。不要把认证命令当作服务命令。访问过期时按上游步骤重新认证,不要把密码写进共享客户端配置。

本说明依据所列文档核对,未代表通过账户认证的实际连接测试;建议检查项需要在你的环境执行。

Garmin MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Garmin MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is Garmin MCP?

This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients. It leverages the python-garminconnect library to access Garmin’s API.

How to use Garmin MCP?

Authenticate once by running uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp-auth. Then add the server to your MCP client (e.g., Claude Desktop) using the uvx command with the garmin-mcp tool. Optionally filter which of the 110+ tools are exposed via the GARMIN_ENABLED_TOOLS or GARMIN_DISABLED_TOOLS environment variables.

Key features of Garmin MCP

  • List and paginate recent activities
  • Edit activity name, type, description, and more
  • Access health metrics: steps, heart rate, sleep, stress
  • View body composition, training status, and readiness
  • Manage gear, workouts, and training plans
  • Download raw activity files (FIT, GPX, TCX, CSV)

Use cases of Garmin MCP

  • Query your weekly training load and recovery status from Garmin Connect
  • Download a FIT file for detailed power and cadence analysis
  • Create and schedule interval workouts without writing Garmin JSON
  • Monitor HRV trend, VO₂ max, and respiration rate over time
  • Manage gear and equipment mileage directly from an LLM chat

常见问题

1

How do I authenticate for the first time?

Run `garmin-mcp-auth` in your terminal. It will prompt for your Garmin email, password, and an MFA code if enabled. OAuth tokens are saved to `~/.garminconnect` and are valid for approximately 6 months.

2

Can I limit which tools are available to the LLM?

Yes. Set `GARMIN_ENABLED_TOOLS` (comma‑separated allowlist) or `GARMIN_DISABLED_TOOLS` (denylist) as environment variables. Only matching tools will be registered, reducing context for the LLM.

3

What data is not accessible through this server?

A few endpoints are intentionally skipped: high‑volume activity details (GPS tracks), sport‑specific workout uploads, and destructive operations like deleting activities. These can be requested via GitHub issues.

4

Where are downloaded activity files saved?

Files go to the directory specified in the `download_activity_file` call argument, the `GARMIN_FIT_DOWNLOAD_DIR` environment variable, or a persisted directory set via `set_fit_download_dir`. On first run, no directory is configured and the tool will prompt you to set one.

5

Does the server require my Garmin credentials in the MCP config?

No. After the one‑time authentication step, tokens are stored locally. You can omit `GARMIN_EMAIL` and `GARMIN_PASSWORD` from the MCP client configuration.

评论

其他 分类下的更多 MCP 服务器