# Garmin Connect Personal API

> Garmin Connect Personal API is an open-source MCP server for health and science. Read-only access to your Garmin Connect sleep, HRV, training and recovery data. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/hannta/garmin-connect-personal-api-mcp
- **MCP Registry name:** io.github.hannta/garmin-connect-personal-api-mcp
- **Categories:** health and science
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/garmin-connect-personal-api-2
