google-health-mcp: ler nesta máquina, com OAuth, dados de saúde já autorizados

Para quem

Já usas Fitbit, Pixel Watch ou um parceiro Google Health e queres ler nesta máquina, via OAuth, dados da Health API v4 que autorizaste. O texto oficial apresenta-o como local-first: os tokens não saem desta máquina. Está atualmente em Beta.

A instalação recomendada aponta para o Hermes: um comando pré-configura este conector e mais 8 numa configuração Hermes dedicada. O título da fonte também nomeia Claude e Cursor. Para quem aceita que dados de saúde saiam para a Google, mas os tokens fiquem nesta máquina.

Se não conseguires concluir o OAuth, ou não quiseres que nenhum pedido relacionado com saúde saia desta máquina, este guia não te ajuda. As notas atuais não nomeiam ferramentas MCP concretas (passos ou frequência cardíaca, por exemplo). Não completes nomes de ferramentas.

Primeira tentativa em 3 minutos

Pré-requisitos: esta máquina consegue correr npx; planeias usar o Hermes (ou ligar outro cliente depois). A instalação oficial de um comando é:

npx -y delx-wellness-hermes setup

Vem de Delx Wellness for Hermes

https://github.com/davidmosiah/delx-wellness-hermes

e pré-configura este conector e mais 8. Na primeira tentativa não abras o scope clinical.

A primeira tentativa usa o comando só de leitura nomeado coverage. A pré-verificação estática antes do OAuth escreve-se coverage --json; não acrescentes --live. O exemplo oficial com o nome de pacote completo só mostra a versão de conta real:

npx -y google-health-mcp-unofficial coverage --live --json

Na primeira tentativa corre primeiro coverage --json no mesmo pacote. Sinal de sucesso observável: sai um relatório coverage e não devem aparecer segredos OAuth, caminhos locais nem medições de saúde em bruto — o texto oficial diz que o comando foi desenhado para isso. Ainda pode alcançar dependências de rede; não leias isto como «sem rede, sem fronteira de privacidade». Depois da pré-verificação, acrescenta --live se quiseres uma conta real. Também é só leitura, mas toca numa conta real; antes de começares, confirma que é a tua própria conta autorizada.

SSH / contentores / WSL podem usar auth --manual para OAuth sem cabeça; esse não é o caminho da primeira tentativa.

Casos de uso

Caso 1: ver a cobertura antes de ligar. Corre coverage --json como pré-verificação estática antes do OAuth. O excerto não lista campos do relatório, por isso o sucesso é «obter cobertura JSON e não ver segredos nem medições em bruto». Não trates o resultado da pré-verificação como já ligado ao Fitbit.

Caso 2: contraste só de leitura contra uma conta real. Corre npx -y google-health-mcp-unofficial coverage --live --json. O texto oficial indica só leitura e omite de propósito segredos OAuth, caminhos locais e medições de saúde em bruto. O excerto não dá parâmetros de filtro nem janela temporal; não trates esta saída como um registo clínico. O scope clinical (ECG/IRN) é opcional; não o abras no primeiro caso.

Limites de uso

Este é o nome de pacote npm não oficial google-health-mcp-unofficial, estado Beta. Os tokens devem ficar nesta máquina, mas os pedidos da Health API ainda saem dela. coverage é desenhado para omitir medições em bruto; isso não equivale a dados nunca pedidos. Não há passos para revogar a autorização, apagar tokens locais ou desligar a configuração Hermes. Os outros 8 conectores pré-configurados em conjunto não são nomeados. Repositório oficial:

https://github.com/davidmosiah/google-health-mcp