O que você precisa
Uma instalação atual do Claude Code, o app telo no iPhone e a sincronização concluída. O Claude Code lê o que o iPhone já enviou para sua conta telo; o comando abaixo não envia nada sozinho.
Se você já adicionou o telo como conector no Claude pela web e entra no Claude Code com a mesma conta Claude, o telo pode já aparecer em /mcp. Nesse caso, pule o comando e vá direto para o login.
Adicione o servidor remoto
O --scope user deixa o telo disponível em todos os projetos deste computador, o que combina com uma fonte de dados pessoal. Sem ele, o servidor fica só no projeto atual. Evite --scope project: ele grava o servidor num arquivo .mcp.json feito para ser commitado e compartilhado.
O comando guarda só o endereço. Nenhum código de login ou token vai para arquivo de configuração, e nada da sua saúde é lido ainda.
claude mcp add --transport http --scope user telo https://telo.health/mcpEntre pelo próprio Claude Code
- Abra o Claude Code e digite /mcp.
- Escolha o telo e a opção de autenticar. O navegador abre a tela de login do telo.
- Entre com o mesmo e-mail que você usa no app telo, revise o acesso pedido e aprove.
- Volte ao terminal. O telo deve aparecer como conectado em /mcp.
Confira se a conexão pode ser usada
- Rode claude mcp list em outro terminal para conferir se o telo está configurado.
- Peça ao Claude Code para usar o telo e listar as métricas e os períodos disponíveis.
- Confirme que ele chama de fato uma ferramenta do telo e devolve a cobertura real. Pare se ele disser que o servidor está indisponível ou responder sem chamar ferramenta.
Uma primeira pergunta sobre seus registros
O Claude Code escreve o script, roda e mostra o gráfico, que é a parte que uma janela de chat não faz. Peça que ele diga quais datas leu antes de confiar numa tendência.
Use o telo para ler meu sono dos últimos 90 dias. Salve um CSV com uma linha por noite, faça um gráfico do sono total com média móvel de 7 dias e liste as noites sem dados em vez de preenchê-las.Mantenha dados de saúde fora dos seus repositórios
Tudo o que o Claude Code salva vai para a pasta em que você o abriu. Faça análises de saúde numa pasta pessoal, não dentro de um repositório de trabalho, e confira o git status antes de commitar.
Os registros que o telo devolve também são processados pela Anthropic como parte da conversa, como qualquer outro resultado de ferramenta.
Problemas comuns
Se o /mcp mostrar o telo com falha ou pedindo autenticação, refaça o login pelo /mcp. Se o navegador não abrir, copie o link que o Claude Code mostra. Confira se a URL é exatamente https://telo.health/mcp.
Se a conexão funciona mas faltam registros, confira a conta e a última sincronização no app telo. Um login bem-sucedido não significa que o iPhone concedeu as permissões do Apple Health nem que terminou de enviar o histórico.
Fontes e disponibilidade
Planos, regiões e telas podem mudar. Confira as fontes oficiais antes de configurar.
Dúvidas práticas
O Claude Code usa a integração de saúde do Claude no iPhone?
Não. Aquela integração é um recurso do app Claude no iPhone, e o Claude Code roda no computador. Para ler o Apple Health no Claude Code, é preciso uma fonte separada por MCP, como o telo.
Preciso rodar o comando se já uso o telo no Claude pela web?
Talvez não. Com a mesma conta Claude, o conector pode já aparecer em /mcp. Se aparecer, só autentique por lá; adicionar de novo pelo terminal cria uma segunda entrada com o mesmo servidor.
Os arquivos que o Claude Code gera saem do meu computador?
Os arquivos ficam na pasta onde você abriu o Claude Code. O que sai é o que a conversa envia: os registros devolvidos pelo telo passam pela Anthropic. Se a pasta for um repositório, um commit pode publicar a análise, então trabalhe numa pasta pessoal.
Como este guia foi preparado
Conteúdo preparado com auxílio de IA, com base na documentação oficial citada e no funcionamento do telo descrito no projeto. As telas e permissões podem variar por conta. Não realizamos nesta revisão um teste autenticado completo em cada assistente.