HealthAPI

Servidor MCP remoto para os dados do Apple Health que você sincroniza do seu iPhone: sono, frequência cardíaca, VFC, treinos e tendências. Somente leitura, aprovado no seu iPhone.

Ver em healthapi.app

Servidor MCP hospedado

npx add-mcp 'https://healthapi.app/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

O que é

O Model Context Protocol (MCP) é como os apps de IA chamam ferramentas externas. O HealthAPI executa um servidor MCP remoto em https://healthapi.app/mcp, via Streamable HTTP. Por trás dele está a sua própria conta HealthAPI, que o app HealthAPI para iPhone mantém sincronizada com o Apple Health.

Seu iPhone sincroniza o Apple Health
O app HealthAPI lê o Apple Health com a sua permissão e sincroniza com a sua conta privada, com totais e médias diárias.
Você adiciona o endereço ao seu app de IA
Ele faz login com OAuth. Uma página do HealthAPI mostra um código curto, e você o aprova no app no seu iPhone.
Seu app de IA chama as ferramentas
Quando você faz uma pergunta, ele chama as ferramentas de que precisa, como o resumo de um dia ou a tendência de uma métrica, e responde com base nos seus dados.

Aprovando um login no HealthAPI. O código corresponde ao da página de login.

Por que não precisa de exportação

Muitos servidores MCP do Apple Health funcionam a partir da exportação XML do app Saúde: você exporta, copia o arquivo para o computador e executa o servidor lá. Isso funciona em um desktop, mas os dados são tão recentes quanto a sua última exportação, e apps de IA na web e no seu celular não conseguem acessar um servidor no seu notebook.

	Baseado em exportação, executado localmente	HealthAPI
Dados	O último arquivo que você exportou	Sincronizados do seu iPhone
Executa em	Seu computador	Hospedado em healthapi.app
Funciona em	Apps naquele computador	Claude na web, desktop e celular, ChatGPT na web e ferramentas de código
Login	Nenhum, ele lê um arquivo local	OAuth, aprovado no seu iPhone

Se você quer que seus dados fiquem inteiramente no seu próprio computador, um servidor local é a escolha certa. Se você quer que eles estejam atualizados e disponíveis onde quer que use IA, um servidor hospedado é a escolha.

Conecte seu cliente

Todo cliente usa o mesmo endereço:

URL

https://healthapi.app/mcp

Cliente	Como
Claude	Encontre o HealthAPI no diretório de conectores do Claude (Customize, Connectors, +) e selecione Connect. Todos os planos, incluindo o Free. Configure na web ou no desktop e funciona também nos apps móveis. Guia completo.
ChatGPT	Plugins, +, adicione um servidor MCP personalizado com o endereço e OAuth, Create as a plugin, depois instale-o e digite @ em um chat. Plus, Pro, Business, Enterprise ou Edu, em chatgpt.com em um navegador no computador; não no Free ou Go. Guia completo.
Mistral Vibe	Connectors, Add connector, Add a custom connector, com o endereço como Server; o OAuth é detectado. Todos os planos, incluindo o Free, em chat.mistral.ai. Guia completo.
Claude Code	`claude mcp add --transport http healthapi https://healthapi.app/mcp`, depois `/mcp` para fazer login.
Cursor, VS Code	Um servidor MCP HTTP com `url` definido como o endereço, em `~/.cursor/mcp.json` ou `.vscode/mcp.json`. Guia do Cursor.
Outros clientes MCP	Um servidor remoto via Streamable HTTP. Clientes que suportam o login OAuth do MCP o encontram sozinhos.

Clientes que enviam cabeçalhos

Uma ferramenta que não consegue executar um login OAuth pode enviar sua chave de API do HealthAPI como um Bearer token. A chave está no app em Connect, depois Other tools. Por exemplo, no Cursor:

~/.cursor/mcp.jsonJSON

{
  "mcpServers": {
    "healthapi": {
      "url": "https://healthapi.app/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

A chave lê tudo o que você sincronizou, então mantenha-a fora de arquivos compartilhados. Regenerá-la no app corta o acesso de toda ferramenta que a possui.

As 8 ferramentas

Toda ferramenta é somente leitura e anotada dessa forma (readOnlyHint), então seu app de IA sabe que nada pode ser alterado. As datas são locais ao seu fuso horário, e uma noite de sono pertence à manhã em que terminou.

Ferramenta	Retorna	Entradas
`get_health_overview`	Todas as métricas com seu primeiro e último dia, histórico de sono e treinos, última sincronização, fuso horário, requisições restantes. Chame primeiro.	Nenhuma
`get_daily_summary`	Um dia: atividade, energia, coração, oxigênio no sangue, frequência respiratória, treinos e o sono daquela manhã.	date (padrão: hoje)
`get_weekly_summary`	Uma semana de segunda a domingo: totais, médias diárias e uma linha por dia.	week, ex.: 2026-W41 (padrão: esta semana)
`get_sleep`	Por noite: dormindo (core, deep, REM), acordado, na cama, hora de dormir e hora de acordar, com médias.	start_date, end_date (padrão: uma semana, até 92 noites)
`get_trend`	Uma métrica dia a dia, um total ou uma média com mínimo e máximo, e a média do período.	metric, days (1 a 365, padrão 30)
`get_latest`	A leitura mais recente de cada métrica, com o momento em que foi registrada.	metrics (padrão: todas)
`get_workouts`	Treinos entre dois dias, mais recentes primeiro, com totais.	start_date, end_date, activity_type, limit (até 100)
`get_samples`	Leituras individuais de uma métrica, para um momento específico, como frequência cardíaca durante uma corrida.	metric, start_date, end_date (até 31 dias), limit (até 500)

Os nomes das métricas são nomes do HealthKit, como restingHeartRate ou vo2Max. Todas as 50 estão listadas aqui. Os mesmos dados estão disponíveis pela API REST.

Login e descoberta

Uma requisição sem token recebe 401 com um cabeçalho WWW-Authenticate apontando para os metadados do recurso protegido, que é como os clientes começam o login. Os endereços:

URLs

https://healthapi.app/mcp
https://healthapi.app/.well-known/oauth-protected-resource/mcp
https://healthapi.app/.well-known/oauth-authorization-server

OAuth 2.1 fluxo de código de autorização com PKCE (S256). Os clientes se identificam com um Client ID Metadata Document ou se registram dinamicamente (RFC 7591).
Um escopo, health.read: ler os dados de saúde sincronizados da conta.
Sem senha. A página de login mostra um código de 6 caracteres e um QR code; você o aprova no app HealthAPI. Ele aguarda 10 minutos.
Tokens: os access tokens duram uma hora; os refresh tokens duram 60 dias e são rotacionados a cada uso, então uma conexão que você usa permanece conectada.

Planos e limites

Cada chamada de ferramenta conta como uma requisição para o seu limite diário do HealthAPI; as outras mensagens do protocolo não contam. Uma pergunta geralmente exige algumas chamadas. A contagem é reiniciada às 00:00 UTC.

Plano	Preço	Requisições por dia
Prévia gratuita (2 dias)	Grátis, sem cartão	25
Pro	US$ 4,99 por mês ou US$ 49,99 por ano	100
Developer	US$ 9,99 por mês ou US$ 99,99 por ano	1.000

Quando as requisições do dia se esgotam, a ferramenta retorna uma mensagem informando quando elas são reiniciadas, que seu app de IA repassa. Os planos diferem apenas no número de requisições por dia. Os planos são comprados e gerenciados no app HealthAPI para iPhone, e você pode cancelar a qualquer momento na App Store.

Grátis por 2 dias, sem necessidade de cartão. Depois, um teste gratuito opcional de 7 dias quando você assinar. A prévia inclui 25 requisições por dia. Quando os 2 dias terminam, os apps de IA e a API param de ler seus dados até você escolher um plano no app. Seus dados sincronizados são mantidos por cerca de 5 semanas, então ao assinar você continua de onde parou.

Segurança e privacidade

Você aprova cada conexão no seu iPhone, e vê cada uma no HealthAPI em Settings, Connected apps, onde pode desconectá-la.
Somente leitura. Nenhuma ferramenta pode alterar ou excluir nada, e o HealthAPI nunca grava no Apple Health.
Somente quando solicitado. Seu app de IA lê seus dados quando você faz uma pergunta, nunca em segundo plano.
Sem credenciais em URLs. O endereço é o mesmo para todos; quem você é vem do login.
Um interruptor para tudo. Regenerar sua chave de API desconecta todos os apps conectados de uma vez. Veja nossa política de privacidade.

Perguntas

Preciso exportar meus dados do Apple Health primeiro?

Não. O app HealthAPI no seu iPhone sincroniza o Apple Health com a sua conta e o mantém atualizado, então o servidor sempre lê seus dados sincronizados mais recentes. Não há arquivo para exportar, converter ou apontar.

Eu executo algo no meu computador?

Não. O servidor é hospedado em https://healthapi.app/mcp. Você adiciona o endereço ao seu app de IA e aprova o login no seu iPhone.

Quais apps de IA podem usá-lo?

Claude em todos os planos, incluindo o Free, a partir do diretório de conectores do Claude. ChatGPT nos planos Plus, Pro, Business, Enterprise ou Edu, configurado em chatgpt.com em um computador. Claude Code, Cursor, VS Code e outros clientes MCP que suportam servidores remotos via HTTP.

Ele pode alterar ou excluir meus dados de saúde?

Não. Todas as oito ferramentas são somente leitura, e são marcadas como somente leitura para o seu app de IA. O HealthAPI nunca grava no Apple Health.

Tem custo extra?

Não, faz parte de todos os planos do HealthAPI. Cada chamada de ferramenta usa uma das suas requisições diárias. Grátis por 2 dias, sem necessidade de cartão. Depois, um teste gratuito opcional de 7 dias quando você assinar. A prévia inclui 25 requisições por dia. Quando os 2 dias terminam, os apps de IA e a API param de ler seus dados até você escolher um plano no app. Seus dados sincronizados são mantidos por cerca de 5 semanas, então ao assinar você continua de onde parou. O Pro custa US$ 4,99 por mês ou US$ 49,99 por ano (100 requisições por dia); o Developer custa US$ 9,99 por mês ou US$ 99,99 por ano (1.000 por dia). Cancele a qualquer momento na App Store.

Como desconecto um app de IA?

No HealthAPI, abra Settings, depois Connected apps, e escolha Disconnect. Regenerar sua chave de API desconecta todos os apps de uma vez.