Garmin Health MCP Server
willc121/garmin-mcp-server
Consulte seus dados de saúde Garmin em português direto no Claude
Ver no GitHubServidor MCP que conecta dados de saúde do Garmin ao Claude Desktop, permitindo consultas em linguagem natural sobre VO2 max, atividades, sono, zonas de frequência cardíaca e carga de treinamento. Integra-se com Supabase para armazenar e consultar histórico de dados de fitness de longo prazo.
Instalação
npx convez-ai willc121/garmin-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Analisar tendências de VO2 max e desempenho aeróbico
- Monitorar sobrecarga de treinamento e prevenir lesões
- Comparar performance entre tipos de atividade
- Analisar qualidade e padrões de sono
- Obter previsões de tempo de prova personalizadas
Veredito

Ferramenta bem implementada para atletas que querem inteligência sobre seus dados Garmin via Claude. Requer setup prévio (Supabase + export de dados), mas oferece queries naturais poderosas para análise de treino e performance.
README
A tradução para o português deste README ainda está na fila.
Garmin Health MCP Server
Query your Garmin health data in plain English through Claude Desktop.
Quick Start
Prerequisites
- Node.js 18+
- Claude Desktop
- Garmin data in Supabase
Install
git clone https://github.com/willc121/garmin-health-mcp-server.git
cd garmin-health-mcp-server
npm install
npm run build
Configure Claude Desktop
Add to your Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"garmin": {
"command": "node",
"args": ["/absolute/path/to/dist/index.js"],
"env": {
"SUPABASE_URL": "your-supabase-url",
"SUPABASE_ANON_KEY": "your-supabase-anon-key"
}
}
}
}
Restart Claude Desktop. The Garmin connector should appear in your connectors menu.
Available Tools
| Tool | Description |
|---|---|
get_health_summary | Overview of all health data |
get_vo2max | VO2 max history and trends |
get_activities | Activity breakdown by type |
get_sleep | Sleep statistics |
get_race_predictions | Predicted race times |
get_heart_rate_zones | Personalized HR training zones |
get_training_load | Acute/chronic workload ratio |
Example Queries
What's my VO2 max?
Am I overtraining?
Compare my running vs cycling this year
Getting Your Garmin Data
1. Request your data export
- Go to Garmin Account Management
- Navigate to Account Settings → Data Management
- Click "Export Your Data" and request all data
- Full instructions →
2. Wait for the email
Garmin sends a download link within 48 hours. The export can be several GB depending on how long you've been tracking.
3. Download and extract
You'll get a zip with JSON files for activities, sleep, VO2 max, heart rate, and more.
4. Load into a database
The raw export is too large to query directly (mine was 9 years of data), so I loaded it into Supabase (free tier works fine).
You'll need these tables:
vo2_max— VO2 max readings by date and sportactivities— Activity records with type, duration, distance, HRsleep_summary— Aggregated sleep statsrace_predictions— Garmin's predicted race timesheart_rate_zones— HR zone boundariestraining_load— Daily training load metrics
I wrote Python scripts to parse the Garmin JSON and insert into Supabase. Happy to share if there's interest — open an issue.
Troubleshooting
| Problem | Fix |
|---|---|
| Connector doesn't appear | Check JSON syntax, use absolute path, fully restart Claude |
| Connection errors | Verify Supabase credentials |
License
MIT
🏃 Powered by questionable cardio and an unhealthy amount of VO2 max anxiety. No treadmills were harmed in the making of this server.