Google Health API に CLI が登場：ghealth は Fitbit Air データのためのオープンソースツール

Google Health API は Fitbit Web API の公式後継であり、ghealth はその API へのアクセスを簡略化する新しいオープンソースのコマンドラインツールです。Go 言語で記述され、単一のバイナリとして提供され、Apache 2.0 ライセンスの下で公開されています。ghealth は Google Health API v4 をラップし、40 種類の検証済みデータ型を提供します。睡眠、心拍数、歩数などのデータを構造化 JSON で出力し、ターミナル環境や AI エージェントでの使用に最適化されています。

このツールは「エージェントファースト」の設計思想に基づいており、各コマンドは安定した形状の簡略化 JSON を返します。また、決定論的な終了コード、--dry-run フラグ、--raw フラグをサポートしています。リポジトリには 2 つの SKILL.md ファイルが含まれており、認証設定と 40 のデータ型の操作詳細が記載されているため、AI エージェントは npx skills add で簡単にインストールできます。

サポートされるデータ型は、Fitbit および Pixel Watch の主要な信号をカバーしており、歩数、心拍数、睡眠、体重、酸素飽和度、心拍変動などが含まれます。一部の臨床データ型（心電図など）には ecg.readonly スコープが必要です。各データ型は特定の操作（list、rollup、daily-rollup、reconcile など）をサポートし、書き込み可能な型（運動、睡眠、体重、体脂肪、身長）には create、update、delete が追加されています。reconcile 操作は複数のソースからの重複データポイントをマージし、v4 API の Reconciled Stream に対応します。

セットアップは「ghealth setup」コマンドで開始され、ウィザードが Google Cloud Console でのデスクトップ型 OAuth クライアント作成をガイドします。ユーザーは自身の OAuth 認証情報を提供し、ツールは共有キーを保持しません。認証情報ファイルは ~/.config/ghealth/ に 0600 のパーミッションで保存され、トークンは自動的に更新されます。すべての Google Health API スコープは「制限付き」に分類され、プロダクション環境での使用にはプライバシーとセキュリティレビューが必要です。個人使用の場合は、自分のプロジェクトを自分のアカウントに対して承認するだけです。

実際の操作では、データの読み取りは一貫したコマンド形式で行えます。たとえば、「ghealth data heart-rate list --from today --limit 10」で最近の心拍数データを取得し、「ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29」で週間の歩数合計を取得できます。デフォルトの出力は簡略化 JSON ですが、--raw で元の API レスポンスを取得したり、--format csv や --format table で他の形式に変換することも可能です。ページネーションは nextPageToken と --page-token を使用してロスレスで行えます。

ユースケースとしては、睡眠データを Claude Code や Codex エージェントにパイプして深い睡眠のトレンドを分析したり、運動データを TCX 形式でエクスポートして pandas で解析したり、30 日間の安静時心拍数を CSV で取得してグラフ化することができます。

他のツールと比較すると、ghealth はエージェントフレンドリーな出力と認証の簡略化を重視しています。生の REST API が最も直接的な制御を提供しますが、ghealth はターミナルやエージェントでの使用における認証とフォーマットの負担を軽減します。このツールは Google-Health-API GitHub 組織でホストされており、コミュニティプロジェクトであって Google 公式のリリースではありません。