O que você precisa
Um iPhone com registros no Apple Health, o app telo da App Store e o Cursor (editor ou CLI). No telo, entre na conta e envie seu histórico; a primeira sincronização precisa terminar antes de qualquer leitura.
Os passos seguem a documentação do Cursor revisada na data acima; não significa que todas as versões foram testadas com o telo.
Adicione o servidor MCP do Apple Health no mcp.json
Coloque a entrada em ~/.cursor/mcp.json para todos os projetos, ou em .cursor/mcp.json dentro de um projeto. Junte com os servidores que já estão lá. Sem cabeçalho e sem chave de API: o telo usa OAuth.
Se a pasta é um repositório compartilhado, prefira o arquivo global, para um commit não contar ao time qual serviço de saúde você usa.
{
"mcpServers": {
"telo": {
"url": "https://telo.health/mcp"
}
}
}Entre com OAuth
No editor, abra Customize na barra lateral, encontre o telo em MCP servers e faça login. Uma página do telo abre no navegador. Informe o e-mail, digite o código de 6 dígitos e aprove o acesso. Nunca cole código nem token no chat.
No CLI, o binário é agent: rode agent mcp login telo.
Confira se o Cursor lê o Apple Health
- No editor, o telo deve listar as ferramentas em Available Tools. No CLI, rode agent mcp list-tools telo.
- Peça ao agente para usar o telo e listar as métricas disponíveis e as datas que elas cobrem.
- Confirme que a resposta vem de uma chamada de ferramenta do telo, com datas reais. Se descrever dados sem chamar ferramenta, está chutando.
- Se nada conectar, abra o painel Output (Cmd+Shift+U) e escolha MCP Logs.
Uma primeira pergunta
Pedir a cobertura primeiro deixa as lacunas visíveis. Um dia sem registro é indisponível, não zero.
Use o telo para conferir quais métricas do Apple Health estão disponíveis e quão recentes elas são. Depois compare meu sono e minha frequência cardíaca em repouso nos últimos 7 dias com os 7 dias anteriores, e liste as datas sem registro.Problemas e remoção
Os Cloud Agents têm login próprio: conectar o telo no desktop não conecta um Cloud Agent, e o contrário também vale.
Para parar de usar o telo, desligue ou apague em Customize; no CLI, rode agent mcp disable telo ou apague a entrada do mcp.json. Se a conexão funciona mas faltam registros, confira a sincronização no app telo. Uma conexão MCP funcionando não prova que as permissões de leitura do HealthKit foram concedidas no iPhone.
Dúvidas práticas
O Cursor tem integração com o Apple Health?
Não. O Cursor lê servidores MCP, e o Apple Health fica no iPhone. Um servidor MCP remoto como o telo recebe os dados do app do iPhone e responde às chamadas de ferramenta do Cursor.
Editor e CLI precisam de configurações separadas?
A entrada do servidor é a mesma: o CLI lê o mesmo mcp.json. Cada superfície faz login na primeira vez, em Customize ou com agent mcp login telo.
Meus dados de saúde vão parar no repositório?
Só se você ou o agente gravarem lá. Os registros voltam para a conversa; se pedir ao Cursor para salvar uma análise, escolha uma pasta fora de qualquer repositório que você publica.
Fontes e disponibilidade
Planos, regiões e telas podem mudar. Confira as fontes oficiais antes de configurar.
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.