Fitbit Air Daily Planner

Fitbit／Pixel Watch由来のGoogle Health APIデータとGoogle Calendarの予定を組み合わせ、ChatGPTがその日のウェルネスプランを作るApps SDK + MCPアプリです。プランは確認カードで承認した場合だけ、専用Googleカレンダーへ登録されます。

単一ユーザー向けのハッカソンMVPです。医療機器ではなく、診断・治療・緊急時対応には使用できません。

なぜこの構成か

• 推論はChatGPT内のGPT-5.6が担当し、OpenAI APIを呼びません。

• サーバーはGoogle Health API v4とCalendar APIの取得・整形・書き込みだけを行います。

• 旧Google Fit REST APIは2026年末、旧Fitbit Web APIは2026年9月に停止予定のため使用しません。

• Calendarのプライマリは読み取り専用、書き込みはGOOGLE_CALENDAR_IDで固定した専用カレンダーだけです。

• Calendarのprivate extended propertyで再試行時の重複登録を防ぎます。

• Cloudflare D1には本人プロフィールと日別集計だけを保存し、前週比と継続利用を実現します。生の心拍時系列やCalendar本文は保存しません。

• 行動目標は厚生労働省「健康づくりのための身体活動・運動ガイド2023」の成人向け推奨値を参考にし、個人差と当日の体調を優先します。

Related MCP server: google-health-mcp

アーキテクチャ

flowchart LR
  D["Fitbit / Pixel Watch"] --> H["Google Health API v4"]
  C["Google Calendar primary"] --> M["Cloudflare Worker / MCP"]
  H --> M
  G["ChatGPT / GPT-5.6"] <-->|"Streamable HTTP"| M
  G --> W["Apps SDK cards"]
  W -->|"confirm"| M
  M --> P["Planner-only Calendar"]
  P --> N["Desktop / mobile reminders"]

MCPツール

ローカルセットアップ

必要環境：Node.js 20以上、npm、Google Cloudプロジェクト。

npm install
cp .dev.vars.example .dev.vars
npm test
npm run check
npm run dev

MCP URLはローカルではhttp://localhost:8787/mcp、ヘルスチェックは/healthzです。ChatGPTからの実機接続には公開HTTPS URLが必要です。

Google Cloud / OAuth

1. Google CloudでGoogle Health APIとGoogle Calendar APIを有効化する。

2. OAuth consent screenをExternal / Testingにし、本人をTest userへ追加する。

3. Web application OAuth clientを作る。

4. 次の最小スコープをData Accessへ追加する。

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/calendar.events

5. OAuth Playgroundまたは補助スクリプトで本人のrefresh tokenを取得する。

GOOGLE_CLIENT_ID=... npm run oauth:url
GOOGLE_CLIENT_ID=... GOOGLE_CLIENT_SECRET=... GOOGLE_AUTH_CODE=... npm run oauth:exchange

GOOGLE_REDIRECT_URIを省略するとOAuth Playground URLを使います。取得した秘密情報は.dev.varsまたはCloudflare Secretsにだけ保存し、コミットしません。

Testingモードのrefresh tokenは7日で失効します。AUTH_EXPIREDになったら再認可してください。未検証アプリは最大100ユーザーで、100ユーザー超または一般公開にはOAuth verificationと第三者セキュリティレビューが必要です。

環境変数

D1プロフィール・ログ

初回ダッシュボードで生年月日を入力すると、D1設定済み環境ではプロフィールへ保存されます。日別ログは歩数、歩数目標、睡眠分数、安静時心拍、欠損項目だけです。

npx wrangler d1 create fitbit-daily-planner
# 出力されたdatabase_idでwrangler.jsoncへDB bindingを追加
npx wrangler d1 migrations apply fitbit-daily-planner --local

追加するbinding：

"d1_databases": [{
  "binding": "DB",
  "database_name": "fitbit-daily-planner",
  "database_id": "作成時に表示されたID"
}]

Cloudflareへのデプロイ手順（現時点では未実施）

npx wrangler login
npx wrangler secret put GOOGLE_CLIENT_ID
npx wrangler secret put GOOGLE_CLIENT_SECRET
npx wrangler secret put GOOGLE_REFRESH_TOKEN
npx wrangler secret put GOOGLE_HEALTH_REFRESH_TOKEN
npx wrangler secret put GOOGLE_CALENDAR_REFRESH_TOKEN
npx wrangler secret put GOOGLE_CALENDAR_ID
npx wrangler secret put MCP_SHARED_SECRET
npm run deploy

Cloudflare Workers Freeは小規模な単一ユーザー利用に十分ですが、無料枠超過時はリクエストが失敗する構成にし、有料機能へ自動移行しないでください。

ChatGPTへの登録と受入確認

ChatGPT BusinessのWeb版で、Workspaceの管理者／オーナーがDeveloper Modeを有効化し、デプロイしたhttps://...workers.dev/mcpをカスタムアプリとして登録します。full MCPとwrite/modify actionsはBusiness / Enterprise / EduのWeb版へbeta提供中であり、利用資格・権限・追加確認UIを実機で確認してください。

推奨プロンプト：

今日の健康サマリーと直近7日の傾向、今日の予定を確認し、無理のないウェルネスプランを作ってください。既存予定と重ねず、最初はカレンダーへ書き込まず確認カードを出してください。

確認項目：

1. 健康カードに実データまたは明示的な欠損が出る。

2. GPTが3つの読み取りツールを使い、プランを説明する。

3. confirm:falseではカレンダーに何も増えない。

4. カードのボタン後に専用カレンダーだけへ登録される。

5. 同じ操作を再実行しても重複しない。

Scheduled Tasksからカスタムアプリを自動呼び出せるかはアカウント／ロールアウト依存の実機検証項目です。非対応でも上記1プロンプト体験を提出版の本線とします。

行動提案の基準

• 成人の既定参考値は、1日60分以上の身体活動（目安約8,000歩）、息が弾み汗をかく程度以上の運動を週60分以上、筋力トレーニングを週2〜3日です。

• 月曜〜日曜を1週間として評価し、土日、とくに日曜日は平日の不足を責めず「今週残っている実行機会」として自宅・近所の有酸素運動を提案できます。1回の運動で日々の不足が完全に帳消しになるとは説明しません。

• ジムやOWLなど外部施設・運動アプリへの誘導は行いません。移動を伴わない選択肢を優先します。

• 本人が別作業でkneeStatus: okと設定し、当日の体調にも問題がない場合は、自重スクワット20秒＋休息10秒×8セット（本編4分）を時短候補にできます。ウォームアップとクールダウンを併記し、膝の痛み・違和感または状態不明時は提案しません。

• 4分メニューを厚労省の週60分と同等換算せず、田畑式原法の効果を一般的な20/10運動へそのまま帰属させません。

制限と安全性

• ChatGPTカスタムMCPと書き込みアクションはBusiness / Enterprise / EduのWeb版が対象です。

• Apps SDK UIはWeb版で確認します。モバイルではカスタムMCPアプリを利用できない場合があります。

• Google Health APIのTesting tokenは7日で失効します。

• Google Health APIの未検証アプリは100ユーザーまでです。

• センサー未装着、同期遅延、機種差により値が欠損します。ゼロとして補完しません。

• 健康状態を断定せず、行動提案は散歩・休憩・ストレッチ・自宅での短時間運動・睡眠習慣など一般的なウェルネス支援に限定します。

• MCPは単一Googleアカウントのtokenを共有します。第三者向けに公開しないでください。

• MCP_SHARED_SECRETを設定し、ChatGPT側で認証を渡せる構成にしてください。認証設定不可ならURLを公開共有しないでください。

撤去

1. Cloudflare Workerを削除する。

2. Google AccountのThird-party accessからアプリの権限を取り消す。

3. Google CloudのOAuth credentialsと専用カレンダーを削除する。

4. ローカルの.dev.varsを削除する。

D1データベースも削除してください。保存対象はプロフィールと日別集計だけで、Durable Objectsや生データの永続コピーはありません。

提出資料

• 制約・技術検証

• 3分デモ台本

• Devpost説明文

• 公開前チェックリスト

本人ログイン、OAuth認可、Developer Mode、デプロイ、実データ確認、録画・公開・提出は別チャット用の手作業票へ分離しています。本リポジトリの実装工程ではデプロイしません。

Codexの利用

Codexを使って、API廃止状況の調査、Google Health API v4への設計変更、MCPツール・Apps SDKカード・OAuth・重複防止・テスト・提出資料を一貫して作成しました。提出時にメイン開発セッションの/feedback IDを追記してください。

License

MIT