一个本地 MCP 服务器，用于通过非官方 Garmin 端点在 Garmin Connect 中创建和安排结构化训练。
这是一个实验性的个人项目。Garmin 可能随时更改端点、限制请求速率或撤销会话。请勿在未添加单独身份验证的情况下将服务器暴露到互联网。
验证已保存的 Garmin 会话；
预览 Garmin JSON 而不做任何更改；
创建训练，并可选择将其添加到日历；
列出训练库和日历；
读取已完成的活动、紧凑摘要和圈数/分段指标；
读取可用的睡眠、HRV、Body Battery、Training Readiness 和 Training Status；
删除训练并从日历中移除训练；
支持跑步、骑行、步行和徒步；
支持时间、距离和 lap button 步骤；
支持间隔重复；
支持配速、心率、功率和踏频目标；
每次更改都需要 confirm=true。
Related MCP server: garmin-mcp
本地使用需要支持 Compose 的 Docker。从仓库根目录构建镜像：
docker compose build构建过程使用 uv 严格从 uv.lock 安装 Python 依赖。
运行一次交互式登录。密码和 MFA 代码直接在容器中输入，不会被存储。OAuth 令牌保存在私有 garmin-mcp_garmin_tokens 命名卷中：
docker compose --profile login run --rm garmin-login启动 MCP 服务器：
docker compose up -d garmin-mcp
docker compose ps端点在 http://127.0.0.1:8000/mcp 可用。要使用不同的本地端口：
GARMIN_MCP_PORT=8765 docker compose up -d garmin-mcp查看日志或停止服务器：
docker compose logs -f garmin-mcp
docker compose downdocker compose down 保留 Garmin 令牌。运行 docker compose down -v 会删除卷及其令牌。
需要 Python 3.12+ 和 uv。
cd /path/to/garmin-mcp
uv sync --extra devuv run garmin-mcp-login脚本在需要时交互式请求电子邮件地址、密码和 MFA 代码。密码不会被存储。OAuth 令牌以受限权限保存到 .garmin-tokens/garmin_tokens.json。该目录已包含在 .gitignore 中。
要将令牌存储到其他位置：
export GARMIN_TOKEN_DIR=/safe/private/path/garmin-tokens
uv run garmin-mcp-loginexport GARMIN_TOKEN_DIR=/safe/private/path/garmin-tokens
uv run garmin-mcp示例 MCP 客户端配置：
{
"mcpServers": {
"garmin": {
"command": "/absolute/path/to/garmin-mcp/.venv/bin/garmin-mcp",
"env": {
"GARMIN_TOKEN_DIR": "/safe/private/path/garmin-tokens"
}
}
}
}export GARMIN_MCP_TRANSPORT=streamable-http
export GARMIN_MCP_HOST=127.0.0.1
export GARMIN_MCP_PORT=8000
export GARMIN_TOKEN_DIR=/safe/private/path/garmin-tokens
uv run garmin-mcp端点：http://127.0.0.1:8000/mcp。
ChatGPT 必须能够通过 HTTPS 访问该端点。可以使用受保护的隧道进行个人测试。请勿将此 MVP 直接暴露到互联网：它有意不包含用于访问 MCP 服务器本身的单独 OAuth 资源服务器。
preview_workout 参数{
"workout": {
"name": "6 x 800",
"sport": "running",
"description": "Controlled intervals",
"blocks": [
{
"steps": [
{
"step_type": "warmup",
"duration_type": "time",
"duration_value": 900
}
]
},
{
"repeat": 6,
"steps": [
{
"step_type": "interval",
"duration_type": "distance",
"duration_value": 800,
"target_type": "pace_seconds_per_km",
"target_low": 250,
"target_high": 260
},
{
"step_type": "recovery",
"duration_type": "time",
"duration_value": 120
}
]
},
{
"steps": [
{
"step_type": "cooldown",
"duration_type": "time",
"duration_value": 600
}
]
}
]
}
}配速值以秒/公里为单位指定：250 = 4:10/km，260 = 4:20/km。服务器会将其转换为 Garmin Connect 使用的 m/s 值。
预览后，使用相同的对象、YYYY-MM-DD 格式的日期和 confirm=true 调用 create_workout。
服务器提供紧凑的只读工具，用于根据已完成的工作调整未来计划：
list_activities 列出包含起止日期的范围内的活动，并带有可选的 Garmin 活动类型过滤器；
get_activity_summary 返回单个活动的规划指标；
get_activity_splits 返回紧凑的圈数和间隔指标；
get_recovery_status 汇总单个日期的可用睡眠、HRV、Body Battery、Training Readiness 和 Training Status。
活动响应有意省略 GPS 坐标和所有者详细信息。恢复指标因 Garmin 设备、账户和日期而异。缺失的来源返回为不可用，不会导致整个恢复请求失败。
uv run --extra dev pytest
uv run --extra dev ruff check .单元测试不联系 Garmin，也不需要凭据。
这不是官方的 Garmin Training API。
频繁登录可能会收到 HTTP 429 响应；请重用保存的令牌。
令牌提供对 Garmin Connect 的访问，必须像密码一样保护。
如果创建成功但调度失败，工具返回 created_not_scheduled 和 workout_id；创建的训练保留在库中。
在常规使用之前，请在 Garmin Connect 和特定手表型号上测试一个简单的训练。
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
List, fetch, create, edit (replace), delete and schedule structured workouts on Garmin Connect (runn
MCP server for Withings health data — sleep, activity, heart, and body metrics.
Wger MCP — wraps wger Workout Manager REST API (free, no auth for read)
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/aapiskotin/garmin-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server