Como dar acesso ao Claude Code aos seus dados de saúde da Apple

A Apple não possui uma API REST do HealthKit. O conector nativo do Apple Health do Claude funciona apenas na web do claude.ai, não no Claude Code. Veja como corrigir isso.

A restrição

O design de privacidade da Apple é o problema central. Os dados do HealthKit nunca saem do seu dispositivo através de uma API do lado do servidor. Não há um endpoint que você possa chamar a partir de um script, uma função em nuvem ou um agente de IA. Todo o acesso ao HealthKit passa por um aplicativo iOS no dispositivo que o usuário concedeu permissão explicitamente.

Isso é, na verdade, bom para a privacidade. Mas cria um problema real se você quiser consultar seus dados de saúde a partir do Claude Code, Cursor ou qualquer cliente MCP que esteja rodando fora da interface web do claude.ai.

As soluções alternativas existentes têm limites. O Health Auto Export é um aplicativo sólido, mas seu servidor MCP funciona sobre TCP local. Sua sessão do Claude Code em um Mac Studio não pode alcançá-lo se seu telefone estiver em uma rede diferente ou se você estiver em uma VPN. O conector Apple Health embutido no claude.ai é ótimo para a interface web, mas não expõe nada ao Claude Code ou a qualquer outro cliente MCP.

A única solução real é construir sua própria camada de sincronização: um aplicativo iOS que lê o HealthKit e envia para um banco de dados que você controla, além de um servidor MCP com o qual o Claude pode se comunicar.

É isso que o health4.ai faz.

O que o health4.ai faz

A arquitetura é direta:

iPhone (HKObserverQuery) → Seu banco de dados Postgres → Servidor FastMCP → Qualquer IA

O aplicativo iOS registra observadores HKObserverQuery para cada tipo de métrica do HealthKit. Quando o Apple Health recebe novos dados (um treino concluído, uma nova leitura de HRV, uma sessão de sono), o observador é acionado e coloca uma sincronização na fila. O BGTaskScheduler gerencia a entrega em segundo plano periódica. Na primeira execução, um backfill em massa exporta todo o seu histórico do HealthKit — o meu tinha cerca de 5,6 milhões de linhas.

Os dados são armazenados em um esquema EAV simples: uma linha por HKSample, com metric_type, value, unit, started_at, ended_at, source_device e uma coluna metadata JSONB. Novos tipos de métricas nunca exigem uma migração de esquema.

O servidor MCP é um processo Python FastMCP rodando localmente. Ele lê diretamente do Postgres (suas credenciais, seu banco de dados) e expõe 11 ferramentas que qualquer cliente MCP pode chamar.

Você é o dono dos dados. O health4.ai nunca recebe ou armazena seus dados de saúde. Eles fluem do seu iPhone para o seu banco de dados Postgres — você escolhe o provedor.

Configuração passo a passo

1. Clone o repositório

git clone https://github.com/jefflitt1/health4ai.git
cd health4ai

2. Configure seu banco de dados Postgres

Escolha o backend que se adapta a você e execute o esquema:

Supabase (o nível gratuito funciona bem):

psql "$DATABASE_URL" < web/public/schema.sql

Neon (Postgres sem servidor):

psql "$DATABASE_URL" < web/public/schema.sql

Docker Local:

docker run -d --name health4ai-postgres \
  -e POSTGRES_PASSWORD=suasenha -p 5432:5432 postgres:16
psql "postgresql://postgres:suasenha@localhost:5432/postgres" \
  < web/public/schema.sql

3. Instale o aplicativo iOS

Link do TestFlight: em breve — o aplicativo está em revisão. Faça login com seus detalhes de conexão do Postgres e toque em Iniciar Sincronização.

4. Configure o servidor MCP

cp mcp-server/.env.example mcp-server/.env

Edite mcp-server/.env:

DATABASE_URL=postgresql://...    # sua string de conexão do Postgres
HEALTHKIT_USER_ID=seu_user_id   # qualquer string para identificar seus dados

Instale as dependências:

cd mcp-server && pip install -r requirements.txt

5. Adicione ao Claude Code

{
  "mcpServers": {
    "health4ai": {
      "command": "python",
      "args": ["/path/to/health4ai/mcp-server/main.py"],
      "env": {
        "DATABASE_URL": "postgresql://...",
        "HEALTHKIT_USER_ID": "seu_user_id"
      }
    }
  }
}

Reinicie o Claude Code. Execute /mcp para confirmar. Você deve ver health4ai com 11 ferramentas listadas.

Funciona com o Cursor também — mesmo bloco de configuração em ~/.cursor/mcp.json.

Totalmente local com Ollama:

mcphost --model ollama/llama3.2 \
  --mcp-server "health4ai:python /path/to/health4ai/mcp-server/main.py"

Seus dados e o modelo permanecem no dispositivo. Nada sai da sua máquina.

O que você pode perguntar

Aqui estão prompts que funcionam bem, junto com qual ferramenta eles acionam:

"Como foi meu sono esta semana?" → get_sleep — detalhamento por noite com durações dos estágios Core, Deep e REM.

"Minha HRV está subindo ou descendo este mês?" → get_hrv_trend — médias diárias de SDNN, comparação de 7 dias, direção da tendência.

"Me dê um resumo completo da saúde dos últimos 14 dias." → get_health_summary — passos, HRV, frequência cardíaca em repouso, sono, treinos.

"Como foi ontem?" →