Skip to content
MCP server

Garmin Connect Personal API

Read-only access to your Garmin Connect sleep, HRV, training and recovery data

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science