Projeto IA · Dia 16/100
Como conectar o Garmin no Claude ou no ChatGPT e montar um painel com seus dados
A Garmin tem uma chave pessoal oficial pros seus próprios dados. Com ela e o pedido pronto desta página, a IA monta no seu computador um painel com seus treinos e os dados de todo dia, sem a chave aparecer na conversa. Funciona no Claude, com o Claude Code, e no ChatGPT, com o Codex: o pedido é o mesmo.
Ver os promptsEm resumo
- Até 07/11/2026 não existia conector oficial do Garmin no Claude: o caminho é a chave pessoal oficial da Garmin (Personal API), criada no Garmin Connect pelo computador.
- A chave vale 30, 90 ou 180 dias, ou 1 ano, aparece uma vez só e fica guardada no cofre de senhas do computador (as Chaves do Mac ou o Gerenciador de Credenciais do Windows), de onde o programa lê sem ela entrar na conversa com a IA.
- Funciona no Claude e no ChatGPT, com o mesmo pedido: colado no Claude Code (plano pago do Claude) ou no Codex (no app do ChatGPT pro computador), ele guia cada passo e monta um painel no navegador com suas atividades e os dados de todo dia, só com números.
Vídeo
Você vai precisar
- Um relógio Garmin e uma conta no Garmin Connect, acessada pelo computador
- No Claude: o Claude Code, que pede um plano pago do Claude, a partir do Pro (conferido em 10/11/2026)
- Ou no ChatGPT: o Codex, no app do ChatGPT pro computador. Vem em todos os planos do ChatGPT, até no grátis, mas no grátis o limite é pra tarefas curtas (conferido em 11/11/2026)
- Um computador Mac ou Windows
O que é a chave pessoal da Garmin (Personal API)
Pensa na carteirinha de um clube que abre uma porta só: a dos seus próprios dados no Garmin Connect, como treinos, sono e passos. A Garmin te dá essa carteirinha, você escolhe por quanto tempo ela vale e pode cancelar quando quiser.
O nome técnico é Personal API, a API pessoal da Garmin: um jeito oficial de um programa no seu computador ler os seus dados. É pra uso pessoal, com os seus dados, e não pra montar um app pra outras pessoas.
A chave não entra direto. O programa troca a chave por um token, que funciona como a pulseira do dia: vale 24 horas e, quando vence, o programa pega outra com a mesma chave.
Quem faz a ponte com a IA é um agente que trabalha no seu computador: o Claude Code, no Claude, ou o Codex, no ChatGPT. Ele escreve o programa que usa a chave e monta o painel.
A chave fica no cofre de senhas do próprio computador: no Mac, as Chaves (o app Acesso às Chaves); no Windows, o Gerenciador de Credenciais. Num arquivo de texto, ela seria uma carteirinha esquecida em cima da mesa. No cofre, o programa pega na hora de usar e ela não aparece na conversa com a IA. É também o que os termos da Garmin pedem: a chave não pode ser mostrada nem passada pra ninguém.
Conferido em 07/11/2026 na página oficial da Garmin sobre a Personal API.
Passo a passo
- Abra uma pasta nova no Claude Code ou no Codex e cole o pedido abaixo. No Claude, é a aba Code do app do Claude no computador; no ChatGPT, é o Codex, no app do ChatGPT pro computador. O pedido é o mesmo nos dois. Ele te guia pelos outros passos, um de cada vez, e espera você responder.
- No computador, entre no Garmin Connect e abra a página da chave pessoal: connect.garmin.com/app/settings/personalApiToken.
- Clique pra criar a chave (em inglês, Create Key) e leia os termos antes de aceitar. O que a Garmin diz sobre o uso tá nas Dúvidas.
- Escolha a validade: 30, 90 ou 180 dias, ou 1 ano. Mais curta é mais segura se a chave vazar; mais longa, você renova menos. A Garmin manda um e-mail mais ou menos uma semana antes de vencer.
- Copie a chave e guarde no cofre de senhas do computador (no Mac, as Chaves; no Windows, o Gerenciador de Credenciais). Ela aparece uma vez só. Use o comando que a IA te der, numa janela do Terminal fora da conversa. Nunca cole a chave no chat nem num arquivo da pasta.
- Deixe a IA puxar os dados. O pedido manda ele testar com um dia antes de puxar o resto e montar o painel, que abre no navegador.
- Confira 3 números no app Garmin Connect. A IA te diz quais. Se algum não bater, peça pra ele achar o motivo antes de confiar no resto.
- Quer gráficos? Cole o segundo pedido. Na mesma conversa, ou abrindo uma conversa nova na pasta do painel, depois que ele estiver pronto.
Os prompts
Monte comigo um painel com os meus dados da Garmin: uma página que abre no navegador do meu computador, feita com a chave pessoal oficial da Garmin (Personal API). Antes, leia a página oficial: https://developer.garmin.com/gc-developer-program/personal/personal-faq/
Eu começo do zero e não sei programar. Você faz a parte técnica e me guia um passo por vez: diz o que eu faço, espera a minha resposta e só então segue. Antes de montar o painel, me pergunte quais esportes eu treino e quais números eu quero ver primeiro, uma pergunta por mensagem.
Você nunca vê a minha chave. Não me peça pra colar a chave aqui: me dê um comando pra eu guardar a chave nas Chaves do Mac (no Windows, no Gerenciador de Credenciais) numa janela do Terminal fora desta conversa, e faça o código ler a chave de lá na hora de usar. A chave tem mais de 128 caracteres: o comando tem que ler a chave do copiar e colar, porque a janelinha de senha do Terminal corta em 128. Nunca rode um comando que mostre a chave ou o token na tela, nem salve os dois em arquivo.
O painel mostra os totais da semana, cada atividade com data, distância, duração e pace, e os dados de todo dia que o meu relógio medir (passos, sono, frequência cardíaca de repouso, o que vier). No fim, me deixe um comando pra atualizar o painel com dados novos.
Regras: use só a chave oficial, sem pedir meu e-mail ou senha da Garmin e sem biblioteca não oficial. Só leia: nunca crie, mude ou apague nada na minha conta. Teste com um dia de dados antes de puxar o resto. Todo número vem da Garmin; o que não vier aparece como "sem dado". O painel mostra números, sem diagnóstico e sem conselho de treino.
Antes de dizer que acabou, confira: o painel abre no navegador, todo número veio da Garmin, e você me disse 3 números pra eu conferir no app Garmin Connect.
Toda mensagem sua termina com uma linha que começa com "Sua vez:" e diz exatamente o que eu faço agora (o que responder, ou escrever "segue"). Na última, diga que acabou, onde está o arquivo do painel e qual comando atualiza.
Meu painel da Garmin já está pronto nesta pasta. Agora deixe ele bonito, com gráficos que chamem atenção. Se não achar o painel aqui, me pergunte onde ele está.
Visual: fundo escuro, quase preto puxado pro roxo, com uma grade bem fraquinha e um brilho roxo suave num canto. Cada bloco é um cartão de cantos arredondados e borda fina. Títulos numa fonte larga e forte; números numa fonte monoespaçada (tipo máquina de escrever), com os dígitos alinhados. Roxo é a cor principal, e amarelo-dourado marca só o que merece atenção (nenhum esporte usa essa cor).
Gráficos, com os últimos 14 dias:
- um anel com o tempo de cada esporte na semana;
- colunas com o tempo de treino de cada dia, coloridas por esporte, e "descanso" escrito nos dias sem atividade;
- o sono de cada noite dividido em profundo, leve e REM, com uma linha na média da semana;
- o Body Battery de cada dia, do mínimo ao máximo;
- os passos de cada dia, com uma marquinha na meta da Garmin;
- a frequência cardíaca de repouso e a VFC, cada uma no seu gráfico.
Cada esporte tem a sua cor, fácil de diferenciar até pra quem tem daltonismo. Passando o mouse, aparece um balão com os números do dia. Se o meu relógio não mede algum desses dados, pule o gráfico e me avise.
Regras: use só os dados que o painel já puxa da Garmin, sem número inventado ou estimado; dia sem dado fica vazio, nunca zero. Não mexa na chave nem na minha conta da Garmin. Continua sem diagnóstico e sem conselho de treino. O comando de atualizar tem que atualizar os gráficos também.
Antes de dizer que acabou, confira: o painel abre no navegador, nenhum número fica encavalado, e 3 números dos gráficos batem com as tabelas do painel (me diga quais).
Toda mensagem sua termina com uma linha que começa com "Sua vez:" e diz exatamente o que eu faço agora (o que responder, ou escrever "segue"). Na última, diga que acabou, como abro o painel e que posso pedir pra mudar qualquer gráfico.
Quais dados da Garmin aparecem no painel
Depende do que o seu relógio mede. A biblioteca que a própria Garmin publicou no GitHub lê, por exemplo, atividades e os detalhes de cada uma, passos, estresse, sono, Body Battery, frequência cardíaca, VFC e SpO2 (conferido em 07/11/2026). O primeiro pedido desta página junta isso em três blocos: totais da semana, cada atividade e os dados de todo dia, com "sem dado" no que não vier.
O painel mostra números, não se você treinou bem nem o que fazer amanhã. Pra juntar esses números com como você se sentiu e levar uma pergunta melhor pro seu treinador, use o pedido do Dia 8: junte os dados do treino com como você se sentiu.
Como eu usei
Eu treino pro meu primeiro Ironman 70.3 e montei o meu painel com este pedido em 08/11/2026, quando o meu Garmin tinha chegado fazia só 6 dias (escolhi a chave de 1 ano, pra não ter que trocar todo mês). Ele já mostrou o meu domingo, 54 minutos de bike no rolo e 12 km na esteira, e eu conferi as minhas 3 últimas atividades no Garmin Connect: todas bateram. Um tropeço: a janelinha de senha do Terminal cortou a minha chave, que tem 133 caracteres, e a Garmin recusou; por isso o pedido manda ler a chave do copiar e colar. Depois eu pedi mais gráficos, e o meu painel ganhou 7: tempo por esporte, treino por dia, sono, Body Battery, passos, FC de repouso e VFC. O segundo pedido desta página pede esses mesmos gráficos. O painel me mostra os números; a decisão do treino continua com o meu treinador.
Dúvidas
- Funciona no ChatGPT?
- Funciona, com o mesmo pedido. No ChatGPT, quem trabalha no seu computador é o Codex: baixe o app do ChatGPT pro computador, escolha o Codex, abra uma pasta nova e cole o pedido desta página. Em 11/11/2026, segundo a página de planos do Codex, ele vem em todos os planos do ChatGPT, até no grátis; no grátis e no Go, o limite é pra tarefas curtas. O meu painel eu montei no Claude Code.
- Tem conector oficial do Garmin no Claude?
- Até 07/11/2026, não: o diretório de conectores do Claude tem o do Strava, mas não um da Garmin. O caminho oficial é a chave pessoal desta página. Se você também usa o Strava, o passo a passo do conector tá no Dia 1: seu Strava dentro do Claude.
- Os termos da Garmin deixam usar os dados com IA?
- A página oficial diz que a chave é pra uso pessoal, com os seus próprios dados, e não pra apps comerciais que atendem várias pessoas (conferido em 07/11/2026). Os termos que aparecem na criação da chave (lidos em 08/11/2026) dizem que ela é só sua, pra ferramentas que você cria ou usa pra você mesmo, e proíbem mostrar ou passar a chave pra qualquer pessoa ou empresa. Sobre IA, não dizem nada. A chave fica fora da conversa, mas parte dos dados que a IA lê pra montar o painel passa por ela.
- A IA consegue mudar meus treinos ou mandar treino pro relógio?
- O pedido desta página só lê e proíbe a IA de criar, mudar ou apagar qualquer coisa na sua conta. Se a chave em si permite escrever, a documentação da Garmin não diz (conferido em 07/11/2026): a biblioteca que a Garmin publicou só lê, e sites que cobriram a abertura, como o the5krunner (22/10/2026), dizem que a chave é só de leitura.
- E se eu perder a chave ou quiser desligar o acesso?
- A chave aparece uma vez só: se perder, apague e crie outra na mesma página do Garmin Connect. Apagar a chave também desliga os tokens dela, então é assim que você corta o acesso quando quiser.
Veja também
-
Dia 8 · Meus dados
Junte os dados do treino com como você se sentiu
O relógio mede o treino, mas não sabe como você se sentiu. Grave 30 segundos de áudio depois do treino, junte com os números do Strava no Claude e leve uma pergunta melhor pro seu treinador. Claude · Strava -
Dia 1 · Meus dados
Seu Strava dentro do Claude
O Strava tem um conector oficial pro Claude. Você conecta uma vez e conversa com ele sobre os seus treinos. Claude · Strava -
Dia 11 · Meus dados
Peça pra IA comparar o seu treino com o que você sentiu
Treino leve, frequência cardíaca alta e você sem sentir nada? Conecte o Strava no Claude e peça pra ele comparar o treino com os seus treinos anteriores e com o que você sentiu. Não precisa ter um coach de IA: uma conversa basta. Claude · Strava