Polar MCP Server

Servidor MCP para a API Polar AccessLink exportar dados de relógios Polar.

GitHub
6
Experimente este MCPPatrocinado

Documentação

Polar MCP Server

Um servidor MCP (Model Context Protocol) para a API Polar AccessLink. Conecte seus dados de condicionamento físico do Polar ao Claude AI - acesse treinos, análise de sono, métricas de recuperação, dados de frequência cardíaca e muito mais.

Início Rápido (Instância Pública)

Sem necessidade de configuração! Use nossa instância hospedada:

  1. No Claude: Configurações → Integrações → Adicionar servidor MCP
  2. Insira a URL: https://polar-mcp-server.n-neuhaeusel.workers.dev/mcp
  3. O Claude abrirá uma janela de autorização — faça login com sua conta Polar
  4. Comece a conversar sobre seus dados de condicionamento físico!

Recursos

25 Ferramentas Disponíveis

CategoriaFerramentasDescrição
Exercíciosget_exercises, get_exerciseDados de treino com FC, velocidade, zonas
Exportação de Exercíciosget_exercise_fit, get_exercise_tcx, get_exercise_gpxExportar nos formatos FIT, TCX, GPX
Sonoget_sleep, get_sleep_rangeEstágios do sono, pontuação, duração
Recuperaçãoget_nightly_recharge, get_nightly_recharge_rangeCarga ANS, VFC, frequência respiratória
Atividadeget_daily_activity, get_daily_activity_range, get_activity_samples, get_activity_samples_rangePassos, calorias, zonas de atividade
Frequência Cardíacaget_continuous_heart_rate, get_continuous_heart_rate_rangeMonitoramento de FC 24/7
Carga de Treinoget_cardio_load, get_cardio_load_range, get_cardio_load_historyTRIMP, carga aguda/crônica
SleepWiseget_sleepwise_alertness, get_sleepwise_circadian_bedtimePrevisões de alerta, horário ideal de dormir
Biossensoriamentoget_body_temperature, get_skin_temperature, get_spo2Dados de temperatura, SpO2
Usuárioget_user_info, get_physical_infoPerfil, VO2max, FC de repouso

Dispositivos Suportados

  • Polar Pacer / Pacer Pro
  • Polar Vantage V2 / V3
  • Polar Vantage M / M2
  • Polar Grit X / Grit X Pro / Grit X2 Pro
  • Polar Ignite / Ignite 2 / Ignite 3
  • Polar Unite
  • E mais...

Exemplos de Comandos

Depois de conectado, pergunte ao Claude:

  • "Mostre-me meus treinos da semana passada"
  • "Como foi meu sono ontem à noite? Compare com minha média semanal"
  • "Analise minhas tendências de variabilidade da frequência cardíaca"
  • "Qual é meu status atual de carga de treino?"
  • "A que horas devo dormir hoje para uma recuperação ideal?"
  • "Exporte minha última corrida como arquivo GPX"
  • "Quantos passos dei este mês?"

Auto-hospedagem

Quer executar sua própria instância? Duas opções de implantação disponíveis:

Opção 1: Cloudflare Workers (Recomendado)

Pré-requisitos

Configuração

# Clone and install
git clone https://github.com/NelsonNew/polar-mcp-server.git
cd polar-mcp-server
npm install

# Create KV namespace
npx wrangler kv namespace create OAUTH_KV
# Copy the ID to wrangler.toml

# Set secrets
npx wrangler secret put POLAR_CLIENT_ID
npx wrangler secret put POLAR_CLIENT_SECRET

# Deploy
npm run deploy

Após a implantação, adicione a URL de callback ao seu aplicativo Polar:

https://YOUR-WORKER.workers.dev/callback

Opção 2: Local (Claude Desktop)

# Clone and build
git clone https://github.com/NelsonNew/polar-mcp-server.git
cd polar-mcp-server
npm install && npm run build

# Get access token
export POLAR_CLIENT_ID="your_client_id"
export POLAR_CLIENT_SECRET="your_client_secret"
npm run auth

Adicione à configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "polar": {
      "command": "node",
      "args": ["/path/to/polar-mcp-server/dist/index.js"],
      "env": {
        "POLAR_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

Referência da API

Todas as ferramentas usam a Polar AccessLink API v3.

FerramentaEndpointDescrição
get_user_info/users/{id}Perfil do usuário
get_physical_info/users/physical-informationVO2max, FC máxima, FC de repouso
get_exercises/exercisesÚltimos 30 dias de treinos
get_exercise/exercises/{id}Detalhes de um único treino
get_exercise_fit/tcx/gpx/exercises/{id}/fit|tcx|gpxFormatos de exportação
get_sleep/users/sleepDados de sono
get_nightly_recharge/users/nightly-rechargeMétricas de recuperação
get_daily_activity/users/activitiesAtividade diária
get_continuous_heart_rate/users/continuous-heart-rateFC 24/7
get_cardio_load/users/cardio-loadCarga de treino
get_sleepwise_alertness/users/sleepwise/alertnessPrevisões de alerta
get_body_temperature/users/biosensing/bodytemperatureTemperatura corporal
get_spo2/users/biosensing/spo2Oxigênio no sangue

Solução de Problemas

ErroSolução
"Polar API error (403)"Reautorize ou verifique se a sincronização de dados está completa
"Polar API error (404)"Endpoint não disponível para seu dispositivo/assinatura
Sem dados de exercícioSincronize seu dispositivo Polar com o aplicativo Polar Flow primeiro

Privacidade

  • Suas credenciais Polar nunca são armazenadas
  • Os tokens OAuth são gerenciados com segurança pelo provedor OAuth do Cloudflare Workers
  • Cada usuário recebe sua própria sessão MCP isolada
  • Nenhum dado de condicionamento físico é registrado ou armazenado em nossos servidores

Contribuição

Contribuições são bem-vindas! Abra uma issue ou PR.

Licença

MIT

Links