convez.ai
MCP ServerIntegração & APIsAvançado
anton-jackson

Garmin MCP Server

anton-jackson/garmin-mcp

Acesso LLM direto aos dados de atividades e saúde do Garmin Connect

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta Claude diretamente aos dados do Garmin Connect: atividades com detalhes FIT completos, métricas de sono e variabilidade da frequência cardíaca (HRV). Hospedado no Google Cloud Run com autenticação por token estático e credenciais seguras em Secret Manager.

Instalação

$npx convez-ai anton-jackson/garmin-mcp

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Analisar tendências de exercícios e performance com Claude
  • Calcular macronutrientes queimados durante atividades
  • Consultar métricas de recuperação (HRV, frequência cardíaca em repouso)
  • Automatizar relatórios de saúde e fitness

Veredito

Integração robusta para quem usa Garmin e quer análise de dados de saúde via IA. Requer setup em Google Cloud Run e bom entendimento de autenticação/segurança, mas oferece acesso granular a dados FIT detalhados e métricas biométricas.

README

A tradução para o português deste README ainda está na fila.

garmin-mcp

A single-user MCP server that gives an LLM (Claude Desktop, etc.) direct access to your Garmin Connect data: activities (with full .FIT detail), sleep, and HRV.

Hosted on Google Cloud Run. Auth via a static bearer token; Garmin credentials and the cached session token live in Secret Manager and Cloud Storage.

Tools

  • list_activities(start_date?, end_date?, limit=20, activity_type?)
  • get_activity(activity_id, include=["summary"|"laps"|"records"|"records_downsampled"], every=10)
  • get_activity_fields(activity_id) — schema introspection without data
  • estimate_activity_macros_burned(activity_id, zone_carb_fractions) — applies a caller-provided 6-element RER table [below-Z1, Z1..Z5]; returns durationMin, activeCalories, carbKcal, carbG, fatKcal, fatG
  • get_daily_metrics(start, end?) — resting HR, HRV, and weight summaries for one day or a date range
  • submit_mfa(code) — only when a prior call returned needs_mfa: true

Deploy

See deploy/deploy.sh. One-time setup creates Secret Manager entries and a GCS bucket for the cached Garmin session token.

Client config (Claude Desktop)

{
  "mcpServers": {
    "garmin": {
      "url": "https://<service>-<hash>.run.app/mcp",
      "headers": { "Authorization": "Bearer <MCP_AUTH_TOKEN>" }
    }
  }
}
Ver o original no GitHub

Bom para

Relacionados