
Garmin Personal MCP
Read-only MCP server for asking AI about Garmin sleep, HRV, Body Battery and activities
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 2 days ago
About Garmin Personal MCP
Garmin Personal MCP is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.
Unlike many Garmin servers, this one avoids your Garmin password. The README explains that most rely on an unofficial library that breaks when Garmin changes its login, whereas this uses the Personal API Garmin opened to individuals in October 2026. You create a revocable key in Garmin Connect, valid from 30 days to a year, and run garmin-personal-mcp auth once to save it with owner-only permissions.
Every working endpoint in Garmin's reference has a tool, with its documented filters. Date ranges longer than an endpoint allows, such as 28 days for steps or 31 for sleep, are split into several requests automatically, and all-day sample arrays are left out unless requested to keep responses model-sized. The README is clear that this is an unofficial project built on the official API, and that it is read-only.
It runs through uvx over stdio, or as an HTTP service from a published Docker image on port 8491. Set TZ in Docker so tools that default to today use your day.
Install
Run in a terminal
claude mcp add garmin-personal-mcp --env GARMIN_PERSONAL_API_KEY='<GARMIN_PERSONAL_API_KEY>' -- uvx garmin-personal-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"garmin-personal-mcp": {
"command": "uvx",
"args": [
"garmin-personal-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"garmin-personal-mcp": {
"command": "uvx",
"args": [
"garmin-personal-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"garmin-personal-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"garmin-personal-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"garmin-personal-mcp": {
"command": "uvx",
"args": [
"garmin-personal-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"garmin-personal-mcp": {
"command": "uvx",
"args": [
"garmin-personal-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>"
}
}
}
}Configuration
GARMIN_PERSONAL_API_KEYGarmin Connect Personal API key (optional; 'garmin-personal-mcp auth' saves one instead)GARMIN_MCP_DOWNLOAD_DIRWhere garmin_download_activity saves activity filesGARMIN_PERSONAL_API_KEYGarmin Connect Personal API key, from Garmin Connect under Settings, Personal APIRequired
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- garmin_download_activity
- Saves an activity file to the configured download folder.
What it does
- Official Personal API
- Uses Garmin's documented API and a revocable key, not your password.
- Full endpoint coverage
- Every working endpoint in Garmin's reference has a tool with its filters.
- Automatic range splitting
- Long date ranges are broken into allowed request sizes.
- Compact responses
- All-day sample arrays are left out unless asked for.
- Activity downloads
- Activity files can be saved to a configured folder.
- Docker option
- A prebuilt image can run the server as an HTTP service.
Good for
- Ask how you slept last night
- Check whether HRV has been trending down this month
- Compare your last three long runs
- Review Body Battery, stress and training load
- Download an activity file for analysis
Pricing
Open source
Free and open source; needs a Garmin Connect account
Garmin Personal MCP FAQ
Does it need my Garmin password?
No. It uses a Personal API key you create in Garmin Connect.
Can it change my Garmin data?
No. The Personal API is read-only and so is the server.
How long does a key last?
You choose from 30 days to a year, and Garmin emails about a week before expiry.
How do I install it?
Run uvx garmin-personal-mcp auth, then add the server to your client; uv is required.
Is it made by Garmin?
No. It is an unofficial project that talks to Garmin's official API.
Is Garmin Personal MCP free?
Yes. Garmin Personal MCP is open source, so you can use and self-host it for free.
How do I add Garmin Personal MCP to Claude Code?
Run this command in your terminal: claude mcp add garmin-personal-mcp --env GARMIN_PERSONAL_API_KEY='<GARMIN_PERSONAL_API_KEY>' -- uvx garmin-personal-mcp
What are the best alternatives to Garmin Personal MCP?
The closest alternatives to Garmin Personal MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).
Alternatives to Garmin Personal MCP

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