eight-sleep-mcp

Eight Sleep MCP

Eight Sleep の睡眠トレンド、温度プログラム、アラームを AI エージェントに共有し、必要に応じて夜間にポッドを調整できるようにします。
ローカルファーストの MCP サーバーです。認証情報がマシンの外に出ることはありません。

⚡ Delx Wellness for Hermes を使えば、ワンコマンドでインストールできます。 npx -y delx-wellness-hermes setup — ウェルネスカタログ内の他の項目と合わせて、このコネクターも事前設定します。

または、Claude Desktop／Cursor／OpenClaw／任意の MCP クライアントに単体で接続することもできます。以下のインストールセクションをご覧ください。

---

HTTP（v2 ステートレス）

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

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

環境変数：EIGHT_SLEEP_MCP_HOST、EIGHT_SLEEP_MCP_PORT、EIGHT_SLEEP_MCP_TRANSPORT=http。

AI エージェントを Eight Sleep ポッドに接続するローカルファーストの MCP サーバーです。睡眠セッション、温度プログラム、アラーム、調整可能なベースにアクセスでき、書き込み操作には明示的な変更ゲートを設けています。

非公式プロジェクトです。 Eight Sleep, Inc. とは提携しておらず、同社による推奨やサポートも受けていません。Eight Sleep は各所有者の商標です。ご自身の Eight Sleep アカウントでのみご利用ください。

Eight Sleep は、安定した公開 API を提供していません。このパッケージは、モバイルアプリが使用するものと同じプライベートエンドポイント（auth-api.8slp.net、client-api.8slp.net、app-api.8slp.net）と通信します。上流のコミュニティプロジェクト（lukas-clarke/eight_sleep、mezz64/pyEight、steipete/eightctl）で十分に文書化されている手法に従っています。

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

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

これが必要な理由

Eight Sleep は、毎晩のスコア、在床時間、tnt、スマート温度スケジュールなど、優れた睡眠データを提供しています。しかし、公開 API のないクローズドな iOS／Android アプリの中に閉じ込められています。現在、エージェントに取り込むには、OAuth のリバースエンジニアリング、トークン更新の管理、エンドポイント形式の正規化、タイムゾーンの癖への対処が必要です。

このパッケージは、これらすべてをローカルで処理し、Model Context Protocol を通じて Eight Sleep を利用できるようにします。設定を 1 つ追加するだけで、MCP 対応のエージェントが睡眠コンテキストを読み取れるようになり（オプトインした場合はポッドへのコマンドも書き込めます）。認証情報とトークンはお使いのマシンに保存されます。

60 秒でセットアップ

npx -y eight-sleep-mcp-unofficial setup   # interactive: email + password
npx -y eight-sleep-mcp-unofficial login   # persists the auth token
npx -y eight-sleep-mcp-unofficial doctor  # verifies you're ready

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

{
  "mcpServers": {
    "eight_sleep": {
      "command": "npx",
      "args": ["-y", "eight-sleep-mcp-unofficial"]
    }
  }
}

Claude Desktop の場合は、setup --client claude を実行すると、設定が書き込まれます。

エージェントで試す

まずは次の 3 つを尋ねてみてください。

Use eight_sleep_connection_status to check setup, then run eight_sleep_get_me.
Tell me what device you find.

Call eight_sleep_get_trends for the last 7 days, response_format=json.
What's my best night and worst night, and why?

Call eight_sleep_get_temperature. Summarize the current smart schedule
(bedtime, initial sleep, final sleep) and tell me if I should tune it.

データの利用可否

このパッケージは Eight Sleep のモバイルアプリ API と通信します。連続的な生体センサーデータのストリームや BLE にはアクセスしません。

データ	ツール	ソース
ユーザーとデバイス	eight_sleep_get_me、eight_sleep_get_user、eight_sleep_get_current_device	client-api.8slp.net /users/...
温度プログラム	eight_sleep_get_temperature	app-api.8slp.net /v1/users/{id}/temperature
睡眠の傾向	eight_sleep_get_trends	client-api.8slp.net /users/{id}/trends
アラーム	eight_sleep_get_alarms	app-api.8slp.net /v2/users/{id}/alarms
調整可能なベース	eight_sleep_get_base	app-api.8slp.net /v1/users/{id}/base

ワークフローツール

ツール	内容
eight_sleep_nightly_summary	複数夜の概要を返します。最高の夜、最低の夜、平均スコア、スコアが 70 未満／85 超の夜をまとめて取得でき、生の get_trends を後処理する必要はありません。
eight_sleep_wellness_context	正規化された delx-wellness-context/v1 ペイロードを返します。他の Delx Wellness ツール（Nourish、Exercise Catalog、Telegram coaches）が Eight Sleep API の詳細を知らなくても、睡眠コンテキストを読み取れるようになります。

変更ツール（書き込みゲート）

デフォルトでは無効です。有効にするには、--allow-mutations を付けてセットアップを再実行するか、EIGHT_SLEEP_ALLOW_MUTATIONS を有効にします。デフォルトの MCP スニペットには、この設定を記述しないでください。

操作	ツール
加熱レベルを設定	eight_sleep_set_temperature
側をオン／オフにする	eight_sleep_set_side
おやすみモードを切り替える	eight_sleep_set_away_mode
アラームをスヌーズする	eight_sleep_snooze_alarm
アラームを停止する	eight_sleep_dismiss_alarm

ゲートがオフの場合、変更ツールは mutations disabled という明示的なエラーを返すため、エージェントは無効になっていることを検知し、ユーザーにオプトインを求められます。

プライバシー

• 認証情報は ~/.eight-sleep-mcp/config.json に保存され、パーミッションは chmod 600 に設定されます。
• 認証トークンは ~/.eight-sleep-mcp/tokens.json に保存され、パーミッションは chmod 600 に設定されます。
• メールアドレス、デバイスのシリアル番号、配送先住所、決済カード番号の末尾 4 桁などの機密フィールドは、デフォルトでツールの応答から削除されます。
• EIGHT_SLEEP_PRIVACY_MODE：
  • summary — 最小限のフィールドのみを返します。
  • structured（デフォルト）— 識別情報を削除しつつ、ネストされた睡眠フィールド全体と、今後追加される上流フィールドを保持します。
  • raw — 上流のペイロード全体を返します（デバッグ専用）。

トレンドのリクエストでは、ネットワーク通信の前に、実在する YYYY-MM-DD 形式の日付、期間の順序、IANA タイムゾーン名が検証されます。

いつでも eight_sleep_privacy_audit を呼び出して、機密情報を公開することなく、現在のプライバシー設定を確認できます。

環境変数

変数	用途
EIGHT_SLEEP_EMAIL	アカウントのメールアドレス。
EIGHT_SLEEP_PASSWORD	アカウントのパスワード。
EIGHT_SLEEP_ALLOW_MUTATIONS	書き込みツールを有効にします（デフォルトのスニペットでは未設定のままにしてください）。
EIGHT_SLEEP_PRIVACY_MODE	summary / structured / raw。
EIGHT_SLEEP_CACHE	ディスク上の応答キャッシュを有効にする場合は sqlite。
EIGHT_SLEEP_TOKEN_PATH	トークンの保存先を上書きします。
EIGHT_SLEEP_CLIENT_ID / EIGHT_SLEEP_CLIENT_SECRET	Android アプリの認証情報のデフォルト値を上書きします（上級者向け）。

安定性

Eight Sleep はモバイルアプリのエンドポイントを予告なく変更します。このコネクターでは、変更による不具合の兆候を把握するため、上流のコミュニティプロジェクト（lukas-clarke/eight_sleep、steipete/eightctl、mezz64/pyEight）を追跡しています。ツールが予期せず 4xx を返すようになった場合は、各リポジトリとプロジェクトのイシューで、最新の正常動作が確認された仕様を確認してください。

クレジット

• lukas-clarke/eight_sleep — Home Assistant の統合。V2 エンドポイントに関する最新の参考情報です。
• mezz64/pyEight — オリジナルの Python ライブラリ。認証とエンドポイントの検出に関する情報を提供します。
• steipete/eightctl — 抽出済みのクライアント認証情報を使用する CLI 版です。
• LiamSnow/opensleep — オープンソースのファームウェア全体を公開しています（この MCP が扱う範囲よりも詳細です）。

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

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

ライセンス

MIT — LICENSE を参照してください。

スキルまたは MCP

同じパッケージを、2 つの方法で利用できます。MCP は stdio／HTTP 上でツールを登録します。スキルを使えば、クライアントに MCP がない場合でも、CLI を通じて同じツールを操作できます。

npx -y eight-sleep-mcp-unofficial call eight_sleep_connection_status --json '{}'

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