Fitbit Mcp Unofficial

Fitbit MCP

Fitbit のアクティビティ、睡眠、心拍数、HRV データを AI エージェントに提供します — ローカルで。
ローカルファーストの MCP サーバー — トークンがマシンの外に出ることはありません。

⚡ Delx Wellness for Hermesによるワンコマンドインストール： npx -y delx-wellness-hermes setup — このコネクターとほかの8つを、専用のHermesプロファイルに事前設定します。

または、Claude Desktop／Cursor／ChatGPT Desktop に単独で組み込むこともできます — 以下のインストールセクションをご覧ください。

---

HTTP（v2 ステートレス）

デフォルトはstdioです。オプションでStreamable HTTPを利用できます。セッションIDは不要で、JSONレスポンスを返し、ループバック接続のみを受け付けます：

npx -y fitbit-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

環境変数：FITBIT_MCP_HOST、FITBIT_MCP_PORT、FITBIT_MCP_TRANSPORT=http。

AI エージェントをFitbitのアクティビティ、睡眠、心拍数、HRV、SpO2、体重データに接続する、ローカルファーストのMCPサーバーです。

非公式プロジェクトです。 FitbitまたはGoogleとは提携、承認、サポート関係にありません。ご自身のFitbitアカウントでのみ、Fitbit Web APIの利用規約に従ってご利用ください。

プラットフォーム移行のリスク： FitbitはGoogle Health APIへの移行を進めています。OAuth、ベースURL、スコープ、再接続フローは2026年に変更される可能性があります。不具合が発生した場合はプラットフォームの変更によるものと考え、バグとして報告する前にFitbit Web APIのドキュメントをご確認ください。

David Mosiahが、Fitbitアプリから数値をコピー＆ペーストせずに、アクティビティ、睡眠、心拍数の情報について考察するため、Claude、Cursor、Hermes、OpenClawなどのMCP互換エージェントを利用する方々に向けて開発しました。

Delx Wellnessの一部です。ローカルファーストのウェルネスMCPコネクターをまとめたレジストリです。

このコネクターがエージェントのワークフローに役立った場合は、ぜひリポジトリにスターを付けてください。スターが増えると、ほかのAI開発者にプロジェクトを見つけてもらいやすくなり、Delxがローカルファーストのウェルネス基盤を提供し続ける助けになります。

このパッケージの目的

Fitbit（現在は Google 傘下）には、日々のアクティビティ、睡眠ステージ、日中の心拍数、HRV、SpO2、呼吸数、体重、食事と水分の記録など、長年にわたるウェアラブルデータが蓄積されています。しかし、API ではスコープごとに認可が必要な OAuth 2.0 が使われており、日中のデータへのアクセス可否はアプリによって異なります。また、プラットフォームは現在、Google Health API への移行中です。

このパッケージは、OAuth の認証フローをローカルで処理し、レスポンスを正規化して、Model Context Protocol を通じて Fitbit を公開します。トークンがマシンの外に出ることはありません。プライバシーモードでは、生のペイロードはデフォルトでオプトインになっています。

60 秒でセットアップ

リダイレクト URI を http://127.0.0.1:3000/callback に設定した Fitbit アプリ（こちらで作成）が必要です。

npx -y fitbit-mcp-unofficial setup    # interactive: paste client id + secret
npx -y fitbit-mcp-unofficial auth     # opens browser, captures the OAuth code
npx -y fitbit-mcp-unofficial doctor   # verifies you're ready

推奨スコープ：

activity heartrate profile settings sleep weight nutrition

次に、これを MCP クライアントの設定に追加します：

{
  "mcpServers": {
    "fitbit": {
      "command": "npx",
      "args": ["-y", "fitbit-mcp-unofficial"]
    }
  }
}

Claude Desktop の場合は、setup --client claude を実行すると、スニペットが自動で作成されます。

エージェントで試す

まず、次の 3 つを尋ねてみましょう：

Use fitbit_connection_status to check setup, then run fitbit_daily_summary.
Give me a 5-line operating brief for today.

Call fitbit_weekly_summary with response_format=json. Identify my biggest
sleep/activity bottleneck and give me a next-week plan.

Use the fitbit_intraday_investigation prompt for date=today, detail_level=1min.
Don't claim anything Fitbit can't actually prove.

データの利用可否

このパッケージでは、公式 Fitbit Web API を使用します。この README で raw と記載されている場合、対応エンドポイントの上流 Fitbit JSON を指しており、デバイスセンサーの生ストリームではありません。

データ	利用可否	備考
日次アクティビティ（歩数、カロリー、距離、ゾーン）	✓	標準的なアクティビティのサマリー
アクティビティログ	✓	記録済みのワークアウト
睡眠＋睡眠ステージ	✓	Fitbit がステージデータを返す場合
安静時心拍数＋日次心拍ゾーン	✓	スコアが付いたすべての日
日中の心拍数サンプル	条件付き	Fitbit アプリ／API で日中のデータへのアクセスが許可されている場合のみ
HRV（夜間）	✓	デバイス／アカウントが対応している場合
SpO2（夜間）	✓	デバイス／アカウントが対応している場合
呼吸数	✓	デバイス／アカウントが対応している場合
体重＋体組成	✓	記録されている場合
食事＋水分の記録	✓	記録されている場合
デバイスの連続テレメトリー	—	Fitbit の公開 API では公開されていません

ツール

まずはこちらから：

• fitbit_connection_status — Fitbit を呼び出す前にローカルのセットアップを確認します
• fitbit_data_inventory — Fitbit API を呼び出さずに、対応するデータ領域、スコープ、プライバシーモード、おすすめの最初の呼び出しを一覧表示します。
• fitbit_daily_summary — 今日のコンディション、アクティビティ、睡眠、心臓の状態を確認します
• fitbit_weekly_summary — スコアカード、前週との比較、来週のプランを確認します

認証と診断

• fitbit_capabilities、fitbit_agent_manifest、fitbit_privacy_audit、fitbit_cache_status
• fitbit_get_auth_url、fitbit_exchange_code、fitbit_revoke_access

プロフィールとデバイス

• fitbit_get_profile、fitbit_list_devices

アクティビティ

• fitbit_get_activity_day、fitbit_list_activities、fitbit_get_activity
• リスト取得の呼び出しでは、Fitbit の相互排他的なカーソル仕様に従い、after または before のいずれかを指定できます。オフセット付き ISO 入力では、記述された暦日が維持され、無効なカーソルは HTTP リクエストの前にエラーになります。

睡眠

• fitbit_get_sleep_day、fitbit_list_sleep

心臓と生理機能（それぞれ date を受け取ります）

• fitbit_get_heart_day、fitbit_heart_series、fitbit_get_heart_intraday
• fitbit_get_hrv_day、fitbit_get_spo2_day、fitbit_get_breathing_rate_day

身体と栄養（それぞれ date を受け取ります）

• fitbit_get_weight_day、fitbit_get_food_day、fitbit_get_water_day

プロンプト

• fitbit_daily_checkin — 実用的な日々の健康・アクティビティの確認
• fitbit_weekly_review — アクティビティ、睡眠、心臓の状態の傾向を確認
• fitbit_intraday_investigation — 1 日分の日中の心拍数サンプルを調査

リソース

• fitbit://capabilities、fitbit://agent-manifest
• fitbit://summary/daily、fitbit://summary/weekly

プライバシーとセキュリティ

• OAuth トークンは ~/.fitbit-mcp/tokens.json に 0600 の権限で保存され、ツールから返されることはありません。
• サーバーがアクセストークンやリフレッシュトークンを出力することはありません。
• FITBIT_PRIVACY_MODE のデフォルトは structured です。生の Fitbit JSON は、raw モードまたは呼び出しごとのオーバーライドを指定した場合にのみ利用できます。
• 構造化モードでは、GPS と秘密情報を含むフィールドを除去しつつ、上流からの生理学的記録とレスポンスメタデータを完全な状態で保持します。
• 健康データは機微情報です。生のペイロードを公開の場に貼り付けないでください。
• これは医療アドバイスではありません。このサーバーは、診断や治療ではなく、個人向け AI ワークフローで利用するユーザーの許可を得たデータを公開します。

設定

setup は、これらの大半を ~/.fitbit-mcp/config.json（0600）に書き込みます。環境変数による手動のオーバーライドもサポートされています。

FITBIT_CLIENT_ID=…
FITBIT_CLIENT_SECRET=…
FITBIT_REDIRECT_URI=http://127.0.0.1:3000/callback

# Optional
FITBIT_SCOPES="activity heartrate profile settings sleep weight nutrition"
FITBIT_PRIVACY_MODE=structured        # summary | structured | raw
FITBIT_CACHE=sqlite                   # retained setting; authenticated payload cache/fallback disabled

認証済みのレスポンスは、ペイロードキャッシュとオフラインフォールバックの両方をバイパスします。既存の SQLite エントリーは保持されます。キャッシュの状態確認によって調査または削除されることはありません。エラーは伝播します。匿名 HTTP キャッシュは引き続き利用できます。

Hermes／リモート設定

npx -y fitbit-mcp-unofficial setup --client hermes --no-auth
npx -y fitbit-mcp-unofficial auth                       # run locally if browser auth is needed
npx -y fitbit-mcp-unofficial doctor --client hermes
hermes mcp test fitbit

Hermes の設定を変更した後は、/reload-mcp または hermes mcp test fitbit を使用してください。通常のデータアクセスでは、ゲートウェイを再起動する必要はありません。

Hermes とは別のマシンでブラウザー OAuth を実行する必要がある場合は、ローカルで auth を実行し、~/.fitbit-mcp/tokens.json を chmod 600 でサーバーにコピーしてください。

要件

• Node.js 20+
• リダイレクト URI が http://127.0.0.1:3000/callback の Fitbit アプリ（https://dev.fitbit.com/apps）
• 日中の心拍数データへのアクセスには、Fitbit アプリが日中データ用に承認されている必要があります（アプリによって異なります）

開発

git clone https://github.com/davidmosiah/fitbit-mcp.git
cd fitbit-mcp
npm install
npm test
npm run build

MCP Inspector でテストします。

npx @modelcontextprotocol/inspector node dist/index.js

リンク

• npm：https://www.npmjs.com/package/fitbit-mcp-unofficial
• ドキュメントサイト：https://wellness.delx.ai/connectors/fitbit
• 旧ドキュメント：https://fitbitmcp.vercel.app/
• GitHub：https://github.com/davidmosiah/fitbit-mcp
• Delx Wellness レジストリー：https://github.com/davidmosiah/delx-wellness
• コネクター品質基準：https://github.com/davidmosiah/delx-wellness/blob/main/docs/connector-quality-standard.md
• Fitbit Web API：https://dev.fitbit.com/build/reference/web-api/

関連項目

Delx Wellness コネクターライブラリーの全一覧：

プロバイダー	パッケージ	リポジトリー
WHOOP	whoop-mcp-unofficial	whoop-mcp
Oura	oura-mcp-unofficial	ouramcp
Garmin	garmin-mcp-unofficial	garminmcp
Strava	strava-mcp-unofficial	strava-mcp
Fitbit	fitbit-mcp-unofficial	fitbit-mcp
Withings	withings-mcp-unofficial	withingsmcp
Apple Health	apple-health-mcp-unofficial	apple-health-mcp
Polar	polar-mcp-unofficial	polarmcp
Nourish（栄養）	wellness-nourish	wellness-nourish

Hermes のワンコマンドセットアップ — 上記のすべてのコネクターに加え、ウェルネススキルとオンボーディングを事前設定します：delx-wellness-hermes.

📧 お問い合わせとサポート

• 📨 [email protected] — 一般的な質問、統合のサポート、パートナーシップ
• 🐛 バグ報告／機能リクエスト — GitHub Issues
• 🐦 最新情報 — X の @delx369
• 🌐 サイト — wellness.delx.ai

ライセンス

MIT — LICENSE をご覧ください。

免責事項

このソフトウェアは現状のまま提供されます。医療機器ではなく、医療上の助言を提供するものでもありません。また、診断や治療に使用しないでください。Fitbit は Google Health API への移行を進めているため、統合の境界が変更される可能性があります。医療に関する懸念がある場合は、必ず資格を持つ専門家に相談してください。

スキルまたは MCP

同じパッケージを、2 通りの方法で利用できます。MCP は stdio／HTTP でツールを登録します。スキルを使うと、クライアントが MCP に対応していない場合でも、CLI 経由で同じツールを実行できます。

npx -y fitbit-mcp-unofficial call fitbit_connection_status --json '{}'

skill/SKILL.md をエージェントのスキルディレクトリにコピーしてください。