O que você precisa
Um iPhone com registros no Apple Health, o app telo da App Store e o Hermes Agent instalado. 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 Hermes Agent 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 config.yaml
Coloque o bloco em ~/.hermes/config.yaml, junto com o que já existe em mcp_servers. Streamable HTTP é o transporte padrão, que é o que o telo serve. Sem client_id nem secret: o telo aceita registro dinâmico de cliente.
mcp_servers:
telo:
url: "https://telo.health/mcp"
auth: oauthEntre com OAuth
Rode num terminal separado, não dentro de uma sessão aberta: o recarregamento da configuração tem um tempo limite curto, que o login interativo pode estourar. 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.
Numa máquina sem navegador, acrescente --flow device. Depois rode /reload-mcp na sessão.
hermes mcp login teloConfira se o Hermes lê o Apple Health
- Rode hermes mcp test telo.
- Peça ao Hermes para usar o telo e listar as métricas disponíveis e as datas que elas cobrem. As ferramentas aparecem como mcp_telo_ seguido do nome.
- Confirme que a resposta vem de uma chamada de ferramenta do telo, com datas reais. Se descrever dados sem chamar ferramenta, está chutando.
- Se o telo não registrar, olhe o agent.log.
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
Para pausar o telo, ponha enabled: false na entrada. Para remover, apague a entrada e o arquivo de token ~/.hermes/mcp-tokens/telo.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 Hermes Agent aceita OAuth em servidor MCP remoto?
Sim. Ele cuida da descoberta, do registro dinâmico de cliente, do PKCE e da renovação do token, então o telo precisa só da URL e de auth: oauth.
Por que fazer login num terminal separado?
O Hermes recarrega a configuração com um tempo limite curto. Um login interativo no navegador dentro da sessão pode passar desse tempo, por isso a doc pede hermes mcp login num terminal próprio.
Onde o Hermes guarda o token do telo?
Em ~/.hermes/mcp-tokens/telo.json, na sua máquina. Apague junto com a entrada da configuração para tirar o acesso.
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.