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