Google Health MCP
⚡ Delx Wellness for Hermes を使用したワンコマンドインストール:
npx -y delx-wellness-hermes setup— このコネクタと他の8つのコネクタを専用のHermesプロファイルに事前設定します。または、Claude Desktop / Cursor / ChatGPT Desktopにスタンドアロンで組み込むことも可能です(以下のインストールセクションを参照)。
新しいGoogle Health API v4のための、非公式かつローカルファーストなMCPサーバーです。
Claude、Cursor、Hermes、OpenClawなどのMCPクライアントが、GoogleのOAuth 2.0フローを通じて、Fitbit、Pixel Watch、およびサポートされているサードパーティソースからユーザーが許可したGoogle Healthデータを読み取れるようにします。
ベータ版ステータス: Googleは、開発者からのフィードバックを取り入れる過程で破壊的な変更が発生する可能性があるため、Google Health API統合の正式なリリースは2026年5月末まで待つことを推奨しています。このコネクタは、今すぐAPIをテストしたい開発者向けに、意図的に早期ベータ版として公開されています。
非公式プロジェクト。 Google、Fitbit、Alphabetとは提携、推奨、サポートされていません。医療機器ではありません。医療アドバイスではありません。
ベータテスター募集
現在最も価値のある貢献は、Fitbit、Pixel Watch、Android、およびGoogle Health API v4ユーザーからの実際のセットアップに関するフィードバックです。
実際のアカウントでテストできる場合は、以下を行ってください:
npx -y google-health-mcp-unofficial doctorを実行し、OAuthフローが明確であることを確認する。MCPクライアントから
google_health_connection_status、google_health_data_inventory、google_health_daily_summaryを試す。データ型の欠落、セットアップ手順の分かりにくさ、クライアント固有の摩擦、プライバシーに関する懸念などがあればIssueをオープンする。
OAuthトークン、クライアントシークレット、個人の健康測定値をパブリックなIssueに貼り付けないでください。
便利なリンク:
Related MCP server: google-health-mcp-server
このプロジェクトの目的
Google Health APIはFitbit Web APIの後継であり、新しいOAuth、新しいベースURL、v4エンドポイントスキーマ、標準化されたデータ型、調整されたストリームとロールアップを備えています。
このMCPは、エージェントがAPIを検出し、セットアップを確認し、ローカルで認証を行い、トークンをプロンプトやエージェント設定に貼り付けることなくデータをクエリするためのクリーンな方法を提供します。
30秒デモ
npx -y google-health-mcp-unofficial setup
npx -y google-health-mcp-unofficial auth
npx -y google-health-mcp-unofficial doctor次に、エージェントを以下のように起動します:
google_health_connection_statusgoogle_health_data_inventorygoogle_health_privacy_auditgoogle_health_daily_summary
インストール
Google Cloud OAuthクライアントを作成し、Google Health APIを有効にして、以下を追加します:
http://127.0.0.1:3000/callback次に、以下を実行します:
npx -y google-health-mcp-unofficial setup
npx -y google-health-mcp-unofficial auth
npx -y google-health-mcp-unofficial doctor推奨される読み取り専用スコープ:
https://www.googleapis.com/auth/googlehealth.profile.readonly
https://www.googleapis.com/auth/googlehealth.settings.readonly
https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
https://www.googleapis.com/auth/googlehealth.sleep.readonly
https://www.googleapis.com/auth/googlehealth.nutrition.readonlyスタンドアロンMCP設定:
{
"mcpServers": {
"google_health": {
"command": "npx",
"args": ["-y", "google-health-mcp-unofficial"]
}
}
}ツール
まずはここから:
google_health_connection_status- ローカル設定、トークン、スコープ、クライアントの準備状況google_health_data_inventory- サポートされているドメイン、スコープ、データ型の命名、エージェントフローgoogle_health_agent_manifest- 機械可読なインストール/ランタイムガイドgoogle_health_daily_summary- ロールアップと調整済みストリームからの日次ベータサマリーgoogle_health_weekly_summary- 週次ベータレビュー
Google Health APIメソッド:
google_health_get_identitygoogle_health_get_profilegoogle_health_get_settingsgoogle_health_list_data_pointsgoogle_health_reconcile_data_pointsgoogle_health_daily_rollupgoogle_health_rollup
診断:
google_health_get_auth_urlgoogle_health_exchange_codegoogle_health_privacy_auditgoogle_health_cache_statusgoogle_health_revoke_accessgoogle_health_wellness_context
データ型に関する注意
エンドポイントパスはケバブケースを使用します:
steps
sleep
heart-rate
daily-resting-heart-rate
daily-heart-rate-variability
active-zone-minutes
total-calories
weight
exerciseフィルタ式はスネークケースを使用します:
steps.interval.civil_start_time >= "2026-05-07"
heart_rate.sample_time.physical_time >= "2026-05-07T00:00:00Z"
sleep.interval.civil_start_time >= "2026-05-07"APIでサポートされているソースファミリー:
users/me/dataSourceFamilies/all-sources
users/me/dataSourceFamilies/google-wearables
users/me/dataSourceFamilies/google-sourcesプライバシー
OAuthトークンは
~/.google-health-mcp/tokens.jsonに0600権限でローカルに保存されます。シークレットは
~/.google-health-mcp/config.jsonまたはGOOGLE_HEALTH_*環境変数に配置できます。ツールがアクセストークン、リフレッシュトークン、クライアントシークレットを返すことはありません。
GOOGLE_HEALTH_PRIVACY_MODE=structuredがデフォルトです。rawモードは明示的なものであり、デバッグや詳細な分析のためにのみ使用してください。
Hermes
npx -y google-health-mcp-unofficial setup --client hermes --no-auth
npx -y google-health-mcp-unofficial auth
npx -y google-health-mcp-unofficial doctor --client hermes
hermes mcp test google_health設定変更後は、/reload-mcp または hermes mcp test google_health を使用してください。通常のデータアクセスのためにゲートウェイを再起動する必要はありません。
開発
git clone https://github.com/davidmosiah/google-health-mcp.git
cd google-health-mcp
npm install
npm testリンク
Google Health API: https://developers.google.com/health
RESTリファレンス: https://developers.google.com/health/reference/rest
Delx Wellnessレジストリ: https://github.com/davidmosiah/delx-wellness
ライセンス
MIT - LICENSE を参照してください。
Available Tools
26 toolsgoogle_health_agent_manifestGoogle Health Agent ManifestARead-onlyIdempotent
Machine-readable install, runtime and client guidance for AI agents. Does not call Google Health or expose secrets.
Inputs: client, response_format. Returns: links, oauth, client, hermes, +12 more
google_health_cache_statusGoogle Health Cache StatusARead-onlyIdempotent
Show optional local SQLite cache status. Enable with GOOGLE_HEALTH_CACHE=sqlite or GOOGLE_HEALTH_CACHE=true.
Inputs: response_format. Returns: path, enabled, entries, http_cache, +1 more
google_health_capabilitiesGoogle Health MCP CapabilitiesBRead-onlyIdempotent
Explain supported Google Health data, privacy boundaries, beta status and recommended agent workflow.
Inputs: response_format. Returns: links, status, creator, project, +11 more
google_health_connection_statusGoogle Health Connection StatusARead-onlyIdempotent
Check local Google Health config, token file, Node version, privacy mode, cache readiness and optional MCP client readiness without calling Google APIs or exposing secrets.
Inputs: client, response_format. Returns: ok, node, cache, oauth, +12 more
google_health_daily_rollupGoogle Health Daily RollupBRead-onlyIdempotent
Aggregate a data type over civil days using Google Health dailyRollUp. Useful for steps, distance, calories, active minutes, weight and heart summaries.
Inputs: end_date, data_type, page_size, page_token, +6 more. Returns: data, endpoint, privacy_mode
google_health_daily_summaryGoogle Health Daily SummaryBRead-onlyIdempotent
Build a practical daily summary from Google Health rollups and reconciled streams when available. Read-only, beta, non-medical.
Inputs: date, timezone, response_format. Returns: kind, generated_at
google_health_data_inventoryGoogle Health Data InventoryARead-onlyIdempotent
Inventory supported Google Health data types, auth scopes, privacy modes and recommended first calls without calling Google APIs.
Inputs: response_format. Returns: auth, kind, links, notes, +12 more
google_health_data_type_coverageGoogle Health Data Type CoverageARead-onlyIdempotent
Build a data-type coverage plan from the official Google Health API data-type table, or run explicit live read-only checks against a real OAuth account. Live mode returns only redacted status and point-count buckets, never raw health payloads.
Inputs: date, live, data_types, response_format, +1 more. Returns: kind, mode
google_health_demoGoogle Health DemoARead-onlyIdempotent
Returns realistic Pixel-Watch-style example payloads of google_health_daily_summary, google_health_wellness_context, and google_health_daily_rollup so agents see the contract before calling real Google Health APIs.
Inputs: response_format.
google_health_exchange_codeExchange Google Health OAuth CodeA
Exchange a Google OAuth authorization code for local tokens. Tokens are stored locally with 0600 permissions and are never returned. Gated: requires explicit user intent — agents must not call this autonomously.
Inputs: code (required), code_verifier (required), response_format. Returns: ok, note, scope, expires_at, +1 more
google_health_get_auth_urlGet Google Health OAuth URLARead-onlyIdempotent
Generate a Google OAuth authorization URL for Google Health API. Use this first when no local token exists.
Inputs: state, scopes, response_format. Returns: scopes, auth_url, next_step, redirect_uri, +1 more
google_health_get_identityGet Google Health IdentityARead-onlyIdempotent
Get the Google Health identity mapping for the authenticated user. Useful for Fitbit-to-Google migrations.
Inputs: privacy_mode, response_format, explicit_user_intent. Returns: data, endpoint, privacy_mode
google_health_get_profileGet Google Health ProfileARead-onlyIdempotent
Get authenticated user profile details from Google Health. Requires profile scope.
Inputs: privacy_mode, response_format, explicit_user_intent. Returns: data, endpoint, privacy_mode
google_health_get_settingsGet Google Health SettingsARead-onlyIdempotent
Get authenticated user settings such as units and timezone. Requires settings scope.
Inputs: privacy_mode, response_format, explicit_user_intent. Returns: data, endpoint, privacy_mode
google_health_list_data_pointsList Google Health Data PointsCRead-onlyIdempotent
Query detailed data points for a Google Health data type. Use kebab-case endpoint data types, e.g. steps, sleep, heart-rate.
Inputs: filter, data_type, page_size, page_token, +3 more. Returns: data, endpoint, privacy_mode
google_health_list_data_typesList Google Health Data TypesARead-onlyIdempotent
List the canonical kebab-case data_type slugs accepted by the data point, reconcile and rollup tools, with each slug's unit, OAuth scope family, and which endpoint verbs (list/reconcile/rollup) support it. Call this before list_data_points, reconcile_data_points, daily_rollup or rollup to choose a valid data_type instead of guessing a slug. Static metadata; does not call Google APIs.
Inputs: response_format. Returns: kind, note, count, source, +3 more
google_health_onboardingDelx Wellness Onboarding FlowARead-onlyIdempotent
Return the 11-question onboarding flow plus the current profile state and missing fields. Read-only — does NOT persist anything. Pair with google_health_profile_update once the user answers. Cross-connector: the same profile is shared by every Delx Wellness MCP (whoop, garmin, oura, fitbit, strava, polar, withings, apple-health, samsung-health, google-health, nourish, cycle-coach, cgm, air).
Inputs: locale, response_format.
google_health_privacy_auditGoogle Health Privacy AuditARead-onlyIdempotent
Return local privacy, cache, token-path and env-presence posture without revealing secret values.
Inputs: response_format. Returns: notes, project, cache_path, token_path, +15 more
google_health_profile_getGet Delx Wellness ProfileARead-onlyIdempotent
Read the shared Delx Wellness profile from ~/.delx-wellness/profile.json. Returns preferred name, goals, devices, training/nutrition/exercise/agent preferences and safety flags. NEVER contains OAuth tokens or API secrets. Read-only.
Inputs: response_format.
google_health_profile_updateUpdate Delx Wellness ProfileA
Persist a partial patch to ~/.delx-wellness/profile.json. Requires explicit_user_intent=true (otherwise returns USER_ACTION_REQUIRED). Rejects secret-like fields (oauth, token, secret, password, cookie, refresh, api_key, session) at write time. Use to record preferred name, goals, devices, training context, nutrition context, exercise preferences, agent preferences, and safety flags.
Inputs: patch (required), response_format, explicit_user_intent.
google_health_quickstartGoogle Health QuickstartARead-onlyIdempotent
Personalized 3-step setup walkthrough for the human user. Adapts to current state (env vars set? token present? what's next?). Call this first when the user asks 'how do I connect Google Health?'
Inputs: response_format.
google_health_reconcile_data_pointsReconcile Google Health Data PointsBRead-onlyIdempotent
Read a reconciled stream for one data type across sources. Supports all-sources, google-wearables and google-sources data source families.
Inputs: filter, data_type, page_size, page_token, +4 more. Returns: data, endpoint, privacy_mode
google_health_revoke_accessRevoke Google Health OAuth AccessADestructive
Revoke the current Google OAuth grant and delete the local token file. Use only when the user explicitly wants to disconnect Google Health. Gated: requires explicit user intent — agents must not call this autonomously.
Inputs: response_format, explicit_user_intent. Returns: ok, note, token_path, local_tokens_cleared
google_health_rollupGoogle Health Physical-Time RollupCRead-onlyIdempotent
Aggregate a data type over physical time intervals using Google Health rollUp.
Inputs: end_time (required), start_time (required), data_type, page_size, +6 more. Returns: data, endpoint, privacy_mode
google_health_weekly_summaryGoogle Health Weekly ReviewARead-onlyIdempotent
Build a weekly Google Health scorecard with activity, sleep, heart context and missing-data awareness. Read-only, beta, non-medical.
Inputs: days, timezone, compare_days, response_format. Returns: kind, generated_at
google_health_wellness_contextGoogle Health Wellness ContextBRead-onlyIdempotent
Normalize Google Health activity/sleep context into the shared wellness_context shape for recommendation engines.
Inputs: days, notes, soreness, timezone, +2 more. Returns: notes, source, soreness, generated_at, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 26 tools
Multiple tools overlap in purpose: connection_status, privacy_audit, and cache_status all touch local config/cache/token readiness; data_inventory, list_data_types, data_type_coverage, and capabilities all describe supported data types/scopes. The get_profile vs profile_get pair is especially easy to confuse because one is a Google Health profile and the other is a local Delx wellness profile.
All tools share the google_health_ prefix and use snake_case, but beyond that the pattern is mixed: verb-first names (get_profile, list_data_points, revoke_access) coexist with noun-first names (profile_get, profile_update) and pure noun names (capabilities, quickstart, data_inventory). This is readable but not a consistent verb_noun convention.
At 26 tools, the server crosses the threshold where the set becomes heavy. Many tools are narrow status/help/metadata endpoints (cache_status, privacy_audit, capabilities, agent_manifest, quickstart, demo) that could reasonably be consolidated into fewer, broader tools without losing capability.
The tool surface covers the main lifecycle for this domain: OAuth setup, identity/profile/settings reads, data type discovery, data point listing, reconciliation, rollups, summaries, local profile persistence, and access revocation. Minor gaps exist (e.g., no explicit token-refresh tool, no update for Google Health settings), but they are unlikely to block the core read-only Google Health workflow.
Maintenance
Related MCP Connectors
Hosted MCP server with managed OAuth for 15+ toolkits: Google Workspace, Fitbit, Oura, Kalshi, etc.
Hosted MCP server for the Healthie EHR & telehealth API: patients, appointments, charting, tasks.
MCP server for Withings health data — sleep, activity, heart, and body metrics.
Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.
Related MCP Servers
- AlicenseBqualityBmaintenanceLocal-first MCP server that connects AI agents to your Fitbit activity, sleep, heart-rate, HRV, SpO2 and weight data.33190 npm5MIT
- AlicenseAqualityDmaintenanceMCP server to read daily activity, sleep, heart rate, and body metrics from Google Health API, allowing AI assistants like Claude to access your health data. Optionally syncs health metrics to an Obsidian vault.5MIT
- AlicenseNot gradedqualityDmaintenanceSelf-hosted MCP server that aggregates personal health data from Google Health, Oura, and Withings into a single, provider-attributed interface with configurable source of truth preferences.MIT
- AlicenseCqualityDmaintenanceA local-first, model-agnostic MCP server that stores personal health data in a SQLite file and provides analysis-ready views for any AI client to log, retrieve, and reason over health records.79MIT