Garmin Workouts MCP

Crie treinos do Garmin Connect usando linguagem natural.

GitHub
2
Experimente este MCPPatrocinado

Documentação

Garmin Workouts MCP

Crie treinos do Garmin Connect usando descrições em linguagem natural. Construído como um servidor MCP (Model Context Protocol).

Instalação

Claude Code (Recomendado)

claude mcp add garmin-workouts-mcp npx garmin-workouts-mcp

Claude Desktop

Adicione ao seu arquivo de configuração:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "garmin-workouts-mcp": {
      "command": "npx",
      "args": ["-y", "garmin-workouts-mcp"]
    }
  }
}

Em seguida, reinicie o Claude Desktop.

Uso

⚠️ Importante: Os tokens de autenticação do Garmin expiram após ~5 minutos. Planeje vários treinos e crie todos em uma única sessão.

Início Rápido

  1. Solicite um treino - Basta descrever o que você quer: "Crie um aquecimento de 10 min, 5x1km de intervalos de limiar com 2 min de descanso, depois 10 min de desaquecimento"

  2. Autentique quando necessário - Uma janela do navegador abrirá no Garmin Connect para você fazer login (acontece quando os tokens expiram ~a cada 5 minutos)

  3. Seu treino aparece - A ferramenta o cria diretamente na sua conta do Garmin Connect e fornece um link para visualizá-lo

  4. Disponível no dispositivo - O treino estará disponível no Garmin Connect e poderá ser enviado ao seu dispositivo a partir de lá

Seu login é salvo temporariamente - Os tokens são armazenados com segurança na sua máquina, mas expiram após ~5 minutos, então você pode precisar reautenticar entre sessões.

Crie vários treinos em uma única sessão:

"Create these 3 workouts:
1. Easy 30 min run in zone 2
2. 5x1km threshold intervals with 2 min rest
3. 10x30 second sprints with 90 second recovery"

Como Funciona

  1. Solicite treinos - Descreva o que você quer criar
  2. Autenticação automática - O navegador abre para login quando os tokens expiram
  3. Criação em lote - Crie vários treinos na mesma sessão

Exemplos de Treinos

  • Corrida fácil: "Corrida fácil de 30 minutos na zona 2"
  • Intervalos: "5x400m no ritmo de 5k com 60 segundos de descanso"
  • Limiar: "10 min de aquecimento, 20 min de tempo na zona 4, 10 min de desaquecimento"
  • Sprints: "Aquecimento de 10 min, depois 8x15 segundos de sprints com 3 min de recuperação"
  • Complexo: "Treino pirâmide: 1-2-3-4-3-2-1 minutos forte com recuperação igual"

Recursos

  • 🧠 Processamento de linguagem natural - Descreva treinos em inglês simples
  • 🔐 Autenticação segura - Autenticação baseada em token com renovação automática
  • 🏃 Suporte a múltiplos esportes - Treinos de corrida, ciclismo e natação
  • ⚡ Integração direta com o Garmin - Cria treinos instantaneamente no Garmin Connect
  • 💾 Gerenciamento inteligente de tokens - Reautenticação automática quando os tokens expiram

Limitações Atuais

⚠️ Apenas alvos de frequência cardíaca/zona - A ferramenta atualmente suporta zonas de frequência cardíaca (Zona 1-5) e alvos específicos de BPM, mas ainda não suporta alvos baseados em ritmo (ex.: 4:00/km).

Como Funciona

  1. Converte sua descrição de treino em linguagem natural em dados estruturados
  2. Traduz para o formato de API de treinos do Garmin com zonas e alvos adequados
  3. Cria o treino diretamente na sua conta do Garmin Connect
  4. Sincroniza automaticamente com o seu dispositivo Garmin

Feito para Claude Code e Claude Desktop.

Aviso Legal

Este projeto é uma ferramenta de terceiros não oficial que interage com a interface web do Garmin Connect. Não é afiliado, endossado ou patrocinado pela Garmin Ltd. ou qualquer uma de suas afiliadas.

  • Use por sua conta e risco - Esta ferramenta pode parar de funcionar se o Garmin alterar sua API ou termos de serviço
  • Não para uso comercial - Este é um projeto pessoal destinado apenas para uso individual
  • Sem garantia - O software é fornecido "como está", sem qualquer garantia
  • Respeite os termos do Garmin - Os usuários são responsáveis por cumprir os termos de serviço do Garmin Connect
  • Responsabilidade pelos dados - Você é responsável pelos treinos criados e por qualquer dado compartilhado com o Garmin

Se você representa o Garmin e tem preocupações sobre este projeto, entre em contato através das issues do GitHub.

Desenvolvimento

Armazenamento de Tokens

Os tokens de autenticação são armazenados com segurança em:

  • Localização: ~/.config/garmin-workouts-mcp/auth.json
  • Permissões: 600 (somente leitura/escrita do usuário)
  • Expiração: ~5 minutos após o login
  • Conteúdo: Tokens JWT e cookies para a API do Garmin Connect

Desenvolvimento Local

# Clone and install
git clone https://github.com/charlesfrisbee/garmin-workouts-mcp.git
cd garmin-workouts-mcp
pnpm install

# Build and test locally
pnpm run build
pnpm run pack

# Add to Claude Code for testing
claude mcp add garmin-workouts-mcp ./garmin-workouts-mcp-local.tgz

Requisitos

  • Node.js 16+
  • pnpm
  • Claude Code (para testes locais)
  • Conta do Garmin Connect