Garmin Connect Personal API
Read-only access to your Garmin Connect sleep, HRV, training and recovery data
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.1.1
- Listing updated
- 2 days ago
About Garmin Connect Personal API
Garmin Connect Personal API is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.
Built on Garmin's official Connect Personal API, this server hands an assistant your own training, recovery and health data and cannot change anything. You create a Personal API key in Garmin Connect on the web, then run the server on your own computer with Node.js 22 or later, or host it on your own Cloudflare account so Claude on the web, mobile and other OAuth-capable clients can reach it.
Its 27 tools range from a one-day snapshot to per-activity detail such as lap rows from the FIT file, time-series streams, heart-rate zones and strength sets. It also covers sleep, HRV, Body Battery, stress, SpO2, weight, hydration, food log and menstrual cycle data. Range tools default to the last 7 days and ask the assistant to split ranges that are too long. Output is metric with units in every field name.
Location, sexual activity and sex drive data are never returned. One known limit is that the laps tool can fail on long activities on the Cloudflare free plan. The project is not affiliated with Garmin and is MIT licensed.
Install
Run in a terminal
claude mcp add garmin-connect-personal-api-mcp --env GARMIN_PERSONAL_API_KEY='<GARMIN_PERSONAL_API_KEY>' -- npx -y @hannta/garmin-connect-personal-api-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"garmin-connect-personal-api-mcp": {
"command": "npx",
"args": [
"-y",
"@hannta/garmin-connect-personal-api-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"garmin-connect-personal-api-mcp": {
"command": "npx",
"args": [
"-y",
"@hannta/garmin-connect-personal-api-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"garmin-connect-personal-api-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hannta/garmin-connect-personal-api-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"garmin-connect-personal-api-mcp": {
"command": "npx",
"args": [
"-y",
"@hannta/garmin-connect-personal-api-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"garmin-connect-personal-api-mcp": {
"command": "npx",
"args": [
"-y",
"@hannta/garmin-connect-personal-api-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Configuration
GARMIN_PERSONAL_API_KEYGarmin Connect Personal API key (optional: the auth command saves one instead)
Tools this server provides (27)
Taken from the project documentation; the running server may differ.
- garmin_get_day
- One day at a glance: sleep, HRV, Body Battery, stress, resting heart rate, intensity minutes and activities.
- garmin_get_days
- The same daily view over a date range, with activity totals and training load.
- garmin_search_activities
- Finds activities in a date range with Garmin IDs and fastest splits, or weekly totals.
- garmin_get_activity
- One activity in depth: pace, heart-rate zones, running dynamics, power, training effect and strength sets.
- garmin_get_activity_streams
- Time series for one activity such as heart rate, pace, cadence, power and elevation.
- garmin_get_activity_laps
- One row per lap or interval rep, taken from the activity's FIT file.
- garmin_get_sleep
- One night's sleep in detail, with score components, sleep need and naps.
- garmin_get_sleep_summaries
- Sleep per night over a date range.
- garmin_get_hrv
- One night's HRV with baseline, status and overnight readings.
- garmin_get_hrv_summaries
- HRV per night over a date range.
- garmin_get_daily_summaries
- Resting heart rate, Body Battery, stress, intensity minutes and steps per day.
- garmin_get_weight
- Weigh-ins and body composition over a date range.
- garmin_get_profile
- Profile settings and heart-rate zones.
- garmin_get_body_battery
- Body Battery per day with the sleep and activity events behind it.
- garmin_get_stress
- Daily stress average and minutes at rest, low, medium and high.
- garmin_get_steps
- Steps per day with goal and distance.
- garmin_get_heart_rate
- One day's resting, minimum and maximum heart rate, optionally per 15 minutes.
- garmin_get_spo2
- One day's blood oxygen, optionally hourly with altitude.
- garmin_get_fitness_age
- Fitness age and its components.
- garmin_get_heart_rate_zones
- Heart-rate zones per sport.
- garmin_get_weight_goals
- Weight goals currently in effect.
- garmin_get_activity_workouts
- The structured workout an activity followed, with targets and repeats.
- garmin_get_hydration
- Daily hydration intake, goal and sweat loss.
- garmin_get_food_log
- One day's food log with calories and macros against goals.
- garmin_get_wellness_activities
- Wellness sessions such as Health Snapshot or breathwork with heart rate, stress, HRV and SpO2.
- garmin_get_menstrual_cycle
- Cycle day, period and fertile window, predictions and analysis.
- garmin_get_menstrual_day
- One day's logged flow, symptoms and moods with that day's cycle summary.
What it does
- Read-only by design
- Only reads data through Garmin's official Personal API.
- Daily recovery snapshot
- Sleep, HRV, Body Battery, stress, resting heart rate and activities for a day or a range.
- Deep activity detail
- Pace, zones, running dynamics, power, laps, streams and workout targets per activity.
- Run locally or on Cloudflare
- Use a local stdio server, or deploy to your own Cloudflare account for remote clients.
- Sensitive data excluded
- Location, sexual activity and sex drive data are never returned.
- Metric output
- Units appear in every field name and dates use your time zone.
Good for
- Ask how last night's sleep and HRV compare to your baseline
- Review a long run's pace, heart-rate zones and laps
- Check recovery before planning a hard training day
- Track weight, hydration and food log against goals
- Follow cycle phase alongside training load
Pricing
Open source
MIT licensed; Cloudflare free plan is enough for hosting apart from one known limit
Garmin Connect Personal API FAQ
Can it change my Garmin data?
No. It is read-only.
What do I need?
A Garmin Connect Personal API key created on the web, and Node.js 22 or later to run it locally.
Can I use it from Claude on the web or mobile?
Yes, by hosting it on your own Cloudflare account and connecting with OAuth.
Is any data withheld?
Location, sexual activity and sex drive data are never returned.
Is it affiliated with Garmin?
No. The README says it is not affiliated with or endorsed by Garmin.
Is Garmin Connect Personal API free?
Yes. Garmin Connect Personal API is open source, so you can use and self-host it for free.
How do I add Garmin Connect Personal API to Claude Code?
Run this command in your terminal: claude mcp add garmin-connect-personal-api-mcp --env GARMIN_PERSONAL_API_KEY='<GARMIN_PERSONAL_API_KEY>' -- npx -y @hannta/garmin-connect-personal-api-mcp
What are the best alternatives to Garmin Connect Personal API?
The closest alternatives to Garmin Connect Personal API are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).
Alternatives to Garmin Connect Personal API

Tooluniverse
MCP serverMCP server giving AI agents access to thousands of scientific research tools
Runs locally- Open source
- 1.8K GitHub stars
- Health and science

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Later Stages
MCP serverCalifornia senior living and care provider records from state licensing and Medicare
- 6 tools
- Remote
- Free
- Health and science
MedXpert 标准检索连接器
MCP serverRead-only local index of medical-device standards with official links, no standard text
Runs locally- 4 tools
- Free
- Legal and government
MedXpert 全球法规连接器 (reg-connector)
MCP serverRead-only local MCP server over a bundled medical-device regulation knowledge base
Runs locally- 7 tools
- Free
- Legal and government

Splyt
MCP serverLet Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep
- Remote
- Free
- Health and science