Garmin Connect MCP
Check Garmin Connect access and retrieve or manage personal Garmin data through MCP tools.
Verify login/connection without returning personal data (
garmin_connection_status,garmin_ping).Retrieve raw private Garmin data: profile, daily stats, heart rate, sleep, HRV, Body Battery, stress, recent activities, and activity details.
List saved workout templates and scheduled workouts for a calendar month.
Schedule an existing workout template and unschedule workouts from the calendar.
Upload Garmin workout JSON to create and schedule a new workout.
Use
YYYY-MM-DDdates where applicable, with today as the default for optional day inputs.
Note: README also lists activity-lap and body-composition tools, but those are not in the provided server schema.
Exposes personal Garmin Connect data, providing tools for retrieving profile, daily stats, heart rate, sleep, HRV, body battery, stress, activities, and workouts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Garmin Connect MCP show my daily stats for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Garmin Connect MCP
An MCP server that exposes your personal Garmin Connect data to MCP-capable clients — Claude Desktop, Claude Code, Codex, and Gemini CLI.
The Garmin work is done by the python-garminconnect library; this repo is the thin MCP layer on top: tool definitions, a stdio server, and privacy guardrails that keep raw health payloads out of durable text. Because python-garminconnect relies on Garmin Connect's unofficial client behavior, it can break if Garmin changes login or endpoint behavior.
Setup
cd /path/to/garminconnect-mcp
python3 -m venv .venv
.venv/bin/python -m pip install -e .
cp .env.example .envEdit .env with GARMIN_EMAIL and GARMIN_PASSWORD.
Run once from a terminal to create or refresh saved Garmin tokens:
.venv/bin/garminconnect-mcp loginIf Garmin asks for MFA, the login command prompts for the code in the terminal.
For non-interactive use, set GARMIN_MFA_CODE temporarily.
The MCP server runs over stdio. Configure Codex with this command:
{
"mcpServers": {
"garmin": {
"command": "/path/to/garminconnect-mcp/.venv/bin/garminconnect-mcp"
}
}
}Claude config files are included too:
.mcp.jsonfor project-scoped Claude Code use.docs/claude_desktop_config.jsonfor Claude Desktop.docs/claude.mdfor setup and verification steps.
Gemini CLI config files are included too:
.gemini/settings.jsonfor project-scoped Gemini CLI use.docs/gemini_settings.jsonfor user-scoped Gemini CLI config.docs/gemini.mdfor setup and verification steps.
Related MCP server: Garmin MCP Server
Tools
Connection-only tools:
garmin_connection_statusgarmin_ping
Raw private Garmin data tools:
garmin_profilegarmin_daily_statsgarmin_heart_rategarmin_sleepgarmin_hrvgarmin_body_batterygarmin_stressgarmin_recent_activities(compact summary by default;compact=falsefor raw)garmin_activitygarmin_activity_laps(per-lap summary with workout step index + compliance)garmin_body_composition(weight/muscle/bone kg, fat %, water %, BMI)
Summarized workout tools:
garmin_workoutsgarmin_scheduled_workoutsgarmin_schedule_workoutgarmin_create_scheduled_workoutgarmin_unschedule_workout
Dates use YYYY-MM-DD. If omitted, tools default to today.
Use garmin_connection_status or garmin_ping for smoke tests. They validate
login without returning profile, health, or account data.
This is a personal local MCP server, and the raw tools intentionally return full Garmin payloads. Avoid pasting those raw responses into docs, examples, issues, or other durable text unless you have sanitized them.
Workout tools return summarized fields instead of raw Garmin payloads. To create
and schedule a new workout, pass Garmin Connect workout JSON to
garmin_create_scheduled_workout; to schedule an existing template, use
garmin_schedule_workout with its workout ID.
Development
scripts/check-private-output.sh
.venv/bin/python -m pytest
.venv/bin/python -m ruff check .
.venv/bin/python -m ruff format --check .
.venv/bin/python -m compileall srcAvailable Tools
16 toolsgarmin_activityC
Get raw private Garmin activity details by activity ID.
Inputs: activity_id (required). Returns: object
garmin_body_batteryA
Get raw private Body Battery data for a date in YYYY-MM-DD format.
Inputs: day. Returns: result
garmin_connection_statusA
Check Garmin Connect login without returning personal data.
Inputs: no named parameters. Returns: object
garmin_create_scheduled_workoutB
Upload a Garmin workout JSON payload, then schedule it on a YYYY-MM-DD date.
Inputs: day (required), workout_json (required). Returns: object
garmin_daily_statsB
Get raw private daily Garmin stats for a date in YYYY-MM-DD format.
Inputs: day. Returns: object
garmin_heart_rateA
Get raw private heart-rate data for a date in YYYY-MM-DD format.
Inputs: day. Returns: object
garmin_hrvB
Get raw private HRV data for a date in YYYY-MM-DD format.
Inputs: day. Returns: object
garmin_pingA
Check Garmin Connect login without returning personal data.
Inputs: no named parameters. Returns: object
garmin_profileA
Get the raw private Garmin Connect user profile.
Inputs: no named parameters. Returns: object
garmin_recent_activitiesC
List raw private recent Garmin activities.
Inputs: limit, start. Returns: result
garmin_scheduled_workoutsA
List scheduled Garmin workouts for a calendar month using 1-12 months.
Inputs: year (required), month (required). Returns: object
garmin_schedule_workoutB
Schedule an existing Garmin workout template on a YYYY-MM-DD date.
Inputs: day (required), workout_id (required). Returns: object
garmin_sleepA
Get raw private sleep data for a date in YYYY-MM-DD format.
Inputs: day. Returns: object
garmin_stressB
Get raw private stress data for a date in YYYY-MM-DD format.
Inputs: day. Returns: object
garmin_unschedule_workoutB
Remove a Garmin workout from the calendar without deleting the template.
Inputs: scheduled_workout_id (required). Returns: object
garmin_workoutsC
List saved Garmin workout templates with summarized fields.
Inputs: limit, start. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools target distinct data types or actions, but there is direct overlap between garmin_connection_status and garmin_ping, both described as checking login status without returning personal data. Also, workout scheduling tools (garmin_create_scheduled_workout vs garmin_schedule_workout) may cause slight confusion, though descriptions clarify differences.
All tools follow a consistent 'garmin_' prefix followed by snake_case nouns or verb-noun phrases (e.g., garmin_activity, garmin_create_scheduled_workout). The naming pattern is uniform and predictable.
With 16 tools covering diverse health and fitness data (activities, body battery, heart rate, sleep, stress, workouts, profile, etc.), the count is well-scoped for a personal data access server. Each tool serves a clear purpose without being excessive.
The tool set covers core query and some mutation operations for Garmin data. However, gaps exist: no tool to delete workout templates (only unschedule), no activity deletion, and no date-range filtering for activities beyond recent. Overall, minor missing features for a comprehensive Garmin management surface.
Maintenance
Related MCP Connectors
Garmin watch data for AI assistants: activities, sleep, HRV, recovery. Never writes to Garmin.
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
Explore Garmin activity and health data with your AI assistant.
Unofficial Garmin Connect access: sleep, HRV, training, activities, workouts and weight.
Related MCP Servers
- AlicenseBqualityBmaintenanceConnects to Garmin Connect and exposes your fitness and health data (activities, sleep, heart rate, steps, body composition) to Claude and other MCP-compatible clients.21481,511MIT
- AlicenseNot gradedqualityDmaintenanceConnects to Garmin Connect and exposes fitness and health data (activities, steps, heart rate, sleep, body composition) to MCP-compatible clients like Claude.MIT
- AlicenseNot gradedqualityDmaintenanceExposes personal Garmin wellness data through MCP tools for accessing summary, sleep, HRV, heart rate, stress, body battery, and historical data.MIT
- FlicenseNot gradedqualityDmaintenanceExposes Garmin Connect health data (steps, sleep, HR, HRV, stress, activities, etc.) as tools for MCP-compatible clients like Claude.-