Como levar os dados do Apple Health para o Home Assistant?

Instale a integração Life Dashboard no Home Assistant pelo Marketplace (HACS antes da versão 2026.11) e o app Life Dashboard no iPhone, depois pareie os dois com o QR code que a integração mostra. Toque em Sincronizar agora, e seus passos, frequência cardíaca, sono, peso e treinos chegam como sensores. Um backfill (o envio de todo o histórico de uma vez) preenche as estatísticas de longo prazo, com cada dia na sua própria data.

Funciona com tudo o que grava no Apple Health (o app Saúde do iPhone): o próprio iPhone, um Apple Watch e os apps de outros relógios, anéis e balanças que salvam os dados ali. As duas partes têm licença MIT. Não há conta nem servidor do Life Dashboard: o iPhone envia direto para o seu Home Assistant, e o app só lê o Apple Health, nunca grava nele.

iPhone ou Apple WatchApple HealthApp Life DashboardHome Assistant

Por Owen Vogelaar, que mantém o Life Dashboard 10 min de leitura

Abrir no Marketplace

O que você precisa

  • Um iPhone com iOS 17 ou mais recente.
  • Home Assistant 2026.3 ou mais recente, para a integração Life Dashboard. A partir da 2026.11 não é preciso instalar mais nada; versões anteriores precisam do HACS. O app do iPhone precisa da integração 0.7.1 ou mais recente; os dois caminhos instalam a versão mais nova.
  • O Life Dashboard para iPhone. Está na App Store por € 6,99 uma única vez (US$ 5,99), sem assinatura. Compilar a partir do código-fonte com o Xcode não custa nada a mais se você já tem uma assinatura do Apple Developer Program.

Configure o Home Assistant primeiro: a configuração do app escaneia o QR code que a integração mostra.

Como configurar

  1. Em Configurações > Marketplace (HACS antes do Home Assistant 2026.11), procure por Life Dashboard, ou use Abrir no Marketplace, e instale. No HACS, baixe a integração e reinicie o Home Assistant.
  2. Se a configuração não abrir sozinha, vá em Configurações > Dispositivos e serviços > Adicionar integração e procure por Life Dashboard. Dê um nome ao iPhone. Confira o campo Home Assistant address: é o endereço para onde o iPhone envia. O iOS só permite http:// sem criptografia para um endereço IP, um nome .local como homeassistant.local ou um nome sem ponto, então http://192.168.1.20:8123 funciona e http://ha.lan:8123 não. Para qualquer outro caso, use https:// ou o Home Assistant Cloud. Em seguida, a janela mostra um QR code.
    A integração Life Dashboard no Home Assistant mostrando um QR code de pareamento
  3. Instale e abra o app Life Dashboard. Em Para onde seus dados devem ir?, toque em Escanear um código de pareamento, escaneie o código e toque em Parear. O app envia um ping de teste, e o iPhone aparece no Home Assistant na hora. A câmera do iPhone também serve: ela abre a página de pareamento no Safari, e um botão ali passa o código para o app.
  4. Quando o iOS pedir acesso à rede local, permita. Sem isso, nada chega a um Home Assistant que está em casa.
  5. Escolha seus tipos de dados: Essenciais, Todos os tipos ou Escolher depois. Depois permita o acesso ao Apple Health. Quando há um tipo ativado sobre o qual o iOS ainda não perguntou, a linha Acesso ao app Saúde, em O que enviar, mostra Permitir. O iOS nunca conta a um app se você liberou a leitura, então um tipo recusado simplesmente não envia nada; mude isso no app Saúde, no seu perfil, em Apps, Life Dashboard.
  6. Uma primeira sincronização acontece logo em seguida e mostra o que chegou. Depois disso, Sincronizar agora, na aba Saúde, envia de imediato o que há de novo. O iPhone aparece em Configurações > Dispositivos e serviços > Life Dashboard, com um sensor para cada tipo enviado. A primeira sincronização de um tipo envia os últimos 7 dias dele.
  7. Para dados mais antigos, toque em Enviar histórico, em O que enviar, e escolha até onde voltar, de 30 dias até Todo o histórico. Cada dia entra no Home Assistant na sua própria data. O envio roda enquanto o app está aberto e o iPhone desbloqueado, e mantém a tela ligada nesse meio-tempo. No iOS 26, ele continua quando você troca de app e mostra o progresso na interface do sistema.
A aba Saúde do app para iPhone, com uma linha por destino e os números de hoje

O que você recebe

  • Sensores para 20 dos 28 tipos, com a pressão arterial contando como dois: os passos, a distância, as calorias ativas e as calorias totais de hoje (por exemplo sensor.alex_s_iphone_steps_today), e o valor mais recente de frequência cardíaca, frequência cardíaca em repouso, VFC, último sono, peso, altura, pressão arterial, glicose no sangue, oxigênio no sangue, frequência respiratória, temperatura corporal, temperatura corporal basal, gordura corporal, massa corporal magra, VO2 máx. e a última bebida. Cada valor mais recente traz o horário a que se refere e o app ou aparelho que o gravou.
  • Fases do sono. Com a integração 1.1.0 ou mais recente, sono profundo, leve, REM, tempo acordado e tempo dormindo de cada noite viram sensores e estatísticas, e o Life Dashboard Sleep Card desenha a noite como um hipnograma.
  • Treinos: o último treino e os minutos de hoje e de ontem, com o tipo, o início e o fim de cada sessão.
  • O que você come. Com a integração 1.2.0 ou mais recente, as calorias, as proteínas, os carboidratos e as gorduras das refeições de hoje, vindos do app em que você registra a alimentação, com cada dia como uma estatística.
  • Histórico nas estatísticas de longo prazo: um valor por dia para passos, distância em km, calorias, sono, tempo de exercício e de mindfulness em horas e hidratação, e uma média, um mínimo e um máximo por hora para frequência cardíaca, peso e as outras medições. Um backfill coloca cada dia na sua própria data.
  • Sem contagem em dobro. Passos, distância e calorias vêm das estatísticas do próprio Apple Health, do jeito que o app Saúde conta, então uma caminhada registrada pelo iPhone e pelo Watch conta uma vez só.

Refeições, registros do monitoramento do ciclo e detalhes de treinos são eventos, não valores, então não ganham sensor. Um webhook seu recebe tudo isso por inteiro.

Gráficos e um dashboard

O histórico do próprio sensor mostra quando cada valor chegou, então depois de um backfill ele coloca tudo em hoje. Faça o gráfico da estatística, com o cartão Gráfico de estatísticas. As estatísticas aparecem no seletor de entidades dele com o nome do iPhone:

type: statistics-graph
title: Steps per week
chart_type: bar
period: week
days_to_show: 90
stat_types:
  - change
entities:
  - life_dashboard:<entry>_steps   # pick "Alex's iPhone steps" from the picker

A integração vem com um dashboard Health de exemplo e um tema para copiar, montados com os cartões do próprio Home Assistant, para colar no editor de configuração bruta de um dashboard novo. Troque your_phone nos IDs das entidades pelo nome do seu iPhone e <entry> nos IDs das estatísticas pelo que o seletor mostra, depois remova os cartões dos tipos que você não sincroniza. Um iPhone não envia temperatura da pele, e a variabilidade da frequência cardíaca dele é SDNN, então compare com a linha de base dela mesma, não com a de um celular Android. O tempo de tela tem uma visualização própria, de que um iPhone não precisa. Sensores e estatísticas lista todas as entidades.

O dashboard Health de exemplo no Home Assistant com dados de demonstração: os blocos de hoje, o último treino, a recuperação com a variabilidade da frequência cardíaca comparada à linha de base, e o sono da última noite

Quando as sincronizações rodam

Em Quando enviar, defina um intervalo de 15 minutos ou mais (60 por padrão) ou horários fixos do dia, com dias da semana e horário de silêncio. É o iOS que decide quando um app roda em segundo plano, então um horário fixo quer dizer "não antes de": a sincronização roda na primeira chance que o iOS der depois dele. A Atualização em 2º Plano precisa estar ativada para o app, e o Modo de Pouca Energia a desativa.

Para sincronizar em um minuto exato, crie uma automação no app Atalhos nesse horário que execute Sincronizar dados de saúde. A mesma ação está por trás do widget da tela de Início, de um controle da Central de Controle no iOS 18 e mais recentes, e da Siri.

Quando enviar no app para iPhone, em horários fixos com horário de silêncio

Os sensores de saúde do app Companion do Home Assistant

O app Companion do Home Assistant para iOS também lê o Apple Health. Os sensores do Apple Health dele (#5272, #5638) cobrem passos, frequência cardíaca, peso, pressão arterial, fases do sono e mais, cada um como um sensor com o total de hoje ou a medição mais nova. O histórico deles no Home Assistant começa no dia em que você os ativa, e detalhes de treinos, refeições e monitoramento do ciclo não estão entre eles.

Eles bastam quando você quer os passos de hoje ou o último peso em uma automação ou em um cartão Tile, e um gráfico a partir do dia da ativação já serve. O Life Dashboard acrescenta os 28 tipos com todos os registros e o app ou aparelho que gravou cada um, um backfill de todo o seu histórico com cada dia na sua própria data, e MQTT ou um webhook ao lado do Home Assistant. Fique com o app Companion de qualquer forma: ele cuida de presença, notificações e sensores do aparelho, e os dois rodam lado a lado.

Outros apps de iPhone também enviam o Apple Health para o Home Assistant. Quatro apps comparados coloca lado a lado o app Companion, o HealthSync for Home Assistant, o Health Assistant Link e o Life Dashboard.

Um celular Android na mesma casa

Um iPhone e um celular Android enviam o mesmo payload, então uma integração só recebe os dois. Adicione a integração uma vez por celular e pareie cada um com o seu próprio QR code; cada um vira um dispositivo próprio. O celular Android usa o Life Dashboard para Android, que lê o Conexão Saúde (Health Connect) e também envia o tempo de tela por app; o guia do Conexão Saúde traz os passos. O dashboard de exemplo tem uma visualização que coloca dois celulares lado a lado.

A visão para dois celulares no Home Assistant com dados de demonstração: um celular Android e um iPhone lado a lado, e os dois nos mesmos gráficos

MQTT como alternativa

Se você já tem um broker MQTT rodando, toque em Adicionar destino na aba Saúde e depois em Broker MQTT. Ative Ativar publicação MQTT, preencha os dados do seu broker e toque em Salvar. Um dispositivo chamado Life Dashboard Companion (iOS) aparece com 21 sensores para os mesmos 20 tipos, pelo MQTT Discovery e sem YAML. Escolha um caminho só: com os dois, você fica com dois dispositivos com os mesmos números.

RecursoIntegração Life DashboardMQTT
ConfiguraçãoMarketplace (HACS antes da 2026.11), depois um QR codeInforme o seu broker
HistóricoTodos os dias, até onde o Apple Health tem dados, com um backfillA partir da primeira sincronização
Treinos e mindfulnessHoras por diaNão
Sensores de treinoSimNão
Um celular Android tambémUm dispositivo próprio ao ladoUm dispositivo e um tópico base próprios

Limites

  • O iOS criptografa o Apple Health enquanto o iPhone está bloqueado, então uma sincronização que o iOS inicia nesse momento espera o desbloqueio, e um backfill fica em pausa.
  • Um endereço da rede de casa só sincroniza em casa. O que não pode ser entregue espera em uma fila no iPhone até a próxima sincronização. Um endereço HTTPS público ou o Home Assistant Cloud funciona fora de casa; com o Home Assistant Cloud, os payloads passam pelos servidores dele no caminho.
  • Não há tempo de tela em um iPhone: o iOS só mostra os dados do Tempo de Uso dentro de uma sandbox que não consegue enviar nada para fora.
  • Os dados de um Apple Watch chegam depois que o relógio sincroniza com o iPhone.

Life Dashboard para iPhone

Duas instalações: a integração pelo Marketplace ou pelo HACS e o app no iPhone. Depois disso, pareie com um QR code e rode um backfill.

Baixar na App Store

€ 6,99 uma única vez na App Store, sem assinatura.

Compilar com o Xcode

Abrir no Marketplace Baixar o app para iPhone

O app de código aberto para iPhone que este guia usa. Sem conta, e os dados vão só para onde você apontar. Mais sobre o app.

Perguntas frequentes

Funciona com o iPhone bloqueado?

Não enquanto ele está bloqueado. Nesse estado o iOS criptografa o Apple Health, e nenhum app consegue ler. Uma sincronização que começa com o iPhone bloqueado espera você desbloquear e então envia tudo o que entrou nesse intervalo.

Por que a sincronização não roda no horário exato que eu defini?

Nenhum app de iOS consegue rodar em segundo plano em um minuto escolhido. É o iOS que decide quando, então um horário fixo quer dizer "não antes de". Para um horário exato, uma automação do Atalhos nesse horário executa Sincronizar dados de saúde. Confira também se a Atualização em 2º Plano está ativada e o Modo de Pouca Energia desativado.

O Home Assistant consegue gravar de volta no Apple Health?

Não. O app do iPhone pede só acesso de leitura e nunca grava no Apple Health. Gravar medições de balança e de pressão arterial a partir do Home Assistant é um recurso do Android, no Conexão Saúde.

Preciso do iCloud ou de uma conta de desenvolvedor da Apple?

Para a versão da App Store, nenhuma conta de desenvolvedor da Apple: você compra uma vez, como qualquer outro app. O app lê o Apple Health no iPhone e envia direto para o seu Home Assistant. Para compilar você mesmo, é preciso um Mac com o Xcode e uma assinatura do Apple Developer Program, porque uma Conta Apple gratuita não consegue assinar um app que lê o Apple Health.

Recebo todo o meu histórico de imediato?

Sim, até onde o Apple Health guarda. Toque em Enviar histórico, em O que enviar, e escolha Todo o histórico. Cada dia entra na sua própria data nas estatísticas de longo prazo. Os sensores em si só mostram o valor mais novo.

Apaguei um registro no Apple Health. O Home Assistant fica com ele?

A sincronização seguinte informa o registro apagado. Um treino apagado sai dos sensores de treino, e passos, distância e calorias seguem os totais diários do próprio Apple Health, que cada sincronização envia para hoje e os dois dias anteriores. Um webhook seu recebe todas as exclusões, para você remover o registro do seu próprio armazenamento.