# Como conectar o Garmin no Claude ou no ChatGPT e montar um painel com seus dados

Projeto IA · Dia 16/100 · Tati Veloso · https://tativeloso.com/dia-16
Publicado em 10 de novembro de 2026 · Atualizado em 11 de novembro de 2026 · Funciona em: Claude (Claude Code), ChatGPT (Codex)

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.

## Em 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.

## 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](https://developer.garmin.com/gc-developer-program/personal/personal-faq/).

## Passo a passo

1. **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.
2. **No computador, entre no Garmin Connect e abra a página da chave pessoal:** [connect.garmin.com/app/settings/personalApiToken](https://connect.garmin.com/app/settings/personalApiToken).
3. **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.
4. **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.
5. **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.
6. **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.
7. **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.
8. **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

**Pra colar no Claude Code ou no Codex e montar o seu painel da Garmin**

```
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.
```

**Depois que o painel estiver pronto: gráficos e visual escuro**

```
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](https://github.com/garmin/connect-personal-api-python) 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](/dia-8).

## 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](https://learn.chatgpt.com/docs/pricing), 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](/dia-1).

**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.

> O painel mostra números, não diagnóstico nem conselho de treino. A IA erra: confira os números no Garmin Connect e leve suas dúvidas sobre o treino pro seu treinador ou pro seu médico.

Todos os episódios: https://tativeloso.com/projeto-ia
