MCP

google-health-mcp:在本机用 OAuth 读取已授权的健康数据

适合要让客户端读取自己已授权的 Google Health API v4 数据的人,前提是走本地 OAuth,并且第一次只用只读 coverage,不要先开临床 scope。

官方来源 · google-health-mcp

安装

npx -y delx-wellness-hermes setup

适合谁

你已经用 Fitbit、Pixel Watch 或 Google Health 合作方,希望在本机通过 OAuth 读取自己授权过的 Health API v4 数据。官方把它写成 local-first:令牌不离开这台机器。当前是 Beta。

推荐安装面向 Hermes:一条命令会预配置这个连接器以及另外 8 个,放进专用 Hermes 配置。来源标题也写了 Claude 与 Cursor。适合能接受健康数据出站到 Google、但令牌留在本机的人。

若你不能完成 OAuth,或不想让任何健康相关请求离开本机,这份指南帮不到你。现有说明没有点名具体 MCP 工具(例如步数或心率),不要自行补工具名。

3 分钟完成第一次尝试

前置条件:本机可跑 npx;你准备用 Hermes(或之后再接到其他客户端)。官方一键安装是:

npx -y delx-wellness-hermes setup

它来自 Delx Wellness for Hermes

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

会预配置本连接器和另外 8 个。第一次不要去开 clinical scope。

第一次尝试用已点名的只读命令 coverage。OAuth 之前的静态预检写法是 coverage --json,不要加 --live。带完整包名的官方示例只写出了真实账号版:

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

第一次先在同一包上跑 coverage --json。可观察的成功信号:打出 coverage 报告,且不应出现 OAuth 密钥、本地路径或原始健康测量值——官方写明该命令按这个目标设计。这仍可能访问网络依赖,不要理解成“无网络、无隐私边界”。预检通过后,若要打真实账号,再加 --live;那也是只读,但会碰到真实账号,开始前确认你要用的就是自己的授权账号。

SSH / 容器 / WSL 可用 auth --manual 做无头 OAuth,那不是第一次尝试该走的路。

使用案例

案例 1:接线前先看覆盖面。运行 coverage --json,在还没做 OAuth 时做静态预检。摘录没有列出报告字段,所以成功时只以“得到 JSON 覆盖面、且看不到密钥和原始测量”为准。不要把预检结果当成已经连上 Fitbit。

案例 2:对真实账号做只读对照。运行 npx -y google-health-mcp-unofficial coverage --live --json。官方写明只读,并有意省略 OAuth 密钥、本地路径和原始健康测量。摘录没有给出过滤参数或时间窗;也不要把这次输出当成临床记录。clinical scope(ECG/IRN)是可选开启,第一次案例不要开。

使用边界

这是非官方 npm 包名 google-health-mcp-unofficial,状态为 Beta。令牌应留在本机,但健康 API 请求仍会离开本机。coverage 设计为省略原始测量,并不等于数据从未被请求。没有写出撤销授权、删除本地令牌或关闭 Hermes 配置的步骤。另外 8 个被一起预配置的连接器没有点名。官方仓库:

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