durely insights MCP for Garmin — Claude Code MCP server
The durely insights MCP for Garmin MCP server for Claude Code connects Garmin Connect via official Personal API tokens to inspect training history, recovery, and sleep locally.
Apache-2.0 ★ 2 updated 2026-10-29
claude mcp add --env GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> --env GARMIN_MCP_TIMEZONE=<GARMIN_MCP_TIMEZONE> --env GARMIN_API_KEY_EXPIRES=<GARMIN_API_KEY_EXPIRES> --transport stdio durely-insights-mcp-for-garmin -- npx -y @durely/garmin-insights-mcpWhat durely insights MCP for Garmin does
This tool syncs your Garmin Connect activity logs straight into a local database on your machine. It extracts second-by-second telemetry from original FIT files, covering heart rate, power output, cadence, lap markers, VO2max, and estimated recovery times. Operating strictly in read-only mode, it keeps user IDs and GPS coordinates out of model prompts by default.
Built-in routines evaluate training load, fitness-fatigue trends, and aerobic decoupling across workouts. When standard reporting is insufficient, your assistant runs read-only SQL queries directly against your local records.
You need Node.js 24+ or Docker on your system. Because authentication relies on a personal key with a 30-day to 1-year lifespan, your account password remains completely unexposed.
What it helps with
- evaluate power distribution across interval sessions
- monitor nocturnal HRV and recovery scores over months
- compare specific lap times between past race efforts
- tally annual mileage across running, swimming, and cycling
Example prompts for the agent
- Compare bike splits between my last two triathlons
- Show Body Battery and heart rate readings from yesterday
- How many kilometres did I log across running and cycling last year?
How to install durely insights MCP for Garmin
Platform CLI
claude mcp add --env GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> --env GARMIN_MCP_TIMEZONE=<GARMIN_MCP_TIMEZONE> --env GARMIN_API_KEY_EXPIRES=<GARMIN_API_KEY_EXPIRES> --transport stdio durely-insights-mcp-for-garmin -- npx -y @durely/garmin-insights-mcpReplace <…> with your own values
Platform CLI
codex mcp add durely-insights-mcp-for-garmin --env GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> --env GARMIN_MCP_TIMEZONE=<GARMIN_MCP_TIMEZONE> --env GARMIN_API_KEY_EXPIRES=<GARMIN_API_KEY_EXPIRES> -- npx -y @durely/garmin-insights-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"durely-insights-mcp-for-garmin": {
"command": "npx",
"args": [
"-y",
"@durely/garmin-insights-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>",
"GARMIN_MCP_TIMEZONE": "<GARMIN_MCP_TIMEZONE>",
"GARMIN_API_KEY_EXPIRES": "<GARMIN_API_KEY_EXPIRES>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"durely-insights-mcp-for-garmin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@durely/garmin-insights-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>",
"GARMIN_MCP_TIMEZONE": "<GARMIN_MCP_TIMEZONE>",
"GARMIN_API_KEY_EXPIRES": "<GARMIN_API_KEY_EXPIRES>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> -e GARMIN_MCP_TIMEZONE=<GARMIN_MCP_TIMEZONE> -e GARMIN_API_KEY_EXPIRES=<GARMIN_API_KEY_EXPIRES> durely-insights-mcp-for-garmin npx -y @durely/garmin-insights-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about durely insights MCP for Garmin
How do I install durely insights MCP for Garmin in Claude Code?
Generate a personal token in Garmin Connect web settings, then run claude mcp add garmin-insights-mcp -e GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> -- npx -y @durely/garmin-insights-mcp.
Does this MCP server share my GPS traces or Garmin password?
No passwords are used because it talks to Garmin's official Personal API. Account details and geographic coordinates stay hidden unless you request route information.
What are the runtime prerequisites?
You need Node.js 24+ or a running Docker environment, alongside an active Personal API key created inside your Garmin Connect account.