Eight Sleep Mcp

io.github.davidmosiah由 GitHub 帳號 davidmosiah 發布v0.2.5更新於 Oct 24, 2026

Unofficial Eight Sleep MCP server: read sleep trends, temperature, alarms; gated pod control.

已驗證STDIO僅桌面位置與生活資料與分析

概覽

AI 產生的概覽

非官方在地 MCP 伺服器,讓助理讀取你的 Eight Sleep 睡眠趨勢、溫度排程、鬧鐘與床架,並可選擇性地受控調整床墊。

可以做什麼
  • 檢查連線狀態,讀取帳戶、使用者與目前裝置資訊
  • 讀取智慧溫度排程、睡眠趨勢與鬧鐘,並檢視可調式床架
  • 產生多晚彙總(最佳/最差夜晚、平均分數)與標準化的健康情境資料
  • 在明確開啟後,可設定加熱等級、開關某一側、切換外出模式、延後或關閉鬧鐘
  • 稽核目前的隱私設定而不暴露密鑰
適用情境
適合擁有 Eight Sleep 床墊、希望助理解讀睡眠分數、檢視溫度排程或在夜間調整床墊設定的使用者。它是個人使用的連接器,並非通用的睡眠資料平台。
執行需求
透過 npx(Node.js)以 stdio 在本機執行,可選僅限本機回環的 HTTP。需要 Eight Sleep 帳戶:電子郵件與密碼,可透過 setup 指令或 EIGHT_SLEEP_EMAIL、EIGHT_SLEEP_PASSWORD 變數提供。可選覆寫項包括 EIGHT_SLEEP_CLIENT_ID、EIGHT_SLEEP_CLIENT_SECRET、EIGHT_SLEEP_TOKEN_PATH 與 EIGHT_SLEEP_PRIVACY_MODE。需要連線至 Eight Sleep 的網路端點。
安裝前請注意
它使用 Eight Sleep 未公開的手機應用程式介面,介面可能隨時變更而導致工具失效。憑證與權杖存放在家目錄下的檔案中,需妥善保護;建議使用 setup 指令,而非把密碼寫進用戶端設定。寫入工具預設關閉,需設定 EIGHT_SLEEP_ALLOW_MUTATIONS 開啟,開啟後助理可變更床墊溫度、左右側、外出模式與鬧鐘。raw 隱私模式會暴露完整上游資料。非官方專案,與 Eight Sleep 無關聯。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Eight Sleep Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Eight Sleep MCP

Give your AI agent your Eight Sleep sleep trends, temperature program and alarms — and optionally let it tune the pod overnight.
Local-first MCP server — credentials never leave your machine.

[npm version] [npm downloads] [License MIT] [Site]

[GitHub stars] [Built for MCP] [Hermes one-command setup] [Eight Sleep]

⚡ One-command install with Delx Wellness for Hermes: npx -y delx-wellness-hermes setup — preconfigures this connector alongside the rest of the wellness catalog.

Or wire it standalone into Claude Desktop / Cursor / OpenClaw / any MCP client — see the install section below.


HTTP (v2 stateless)

Default is stdio. Optional Streamable HTTP — no session id, JSON responses, loopback only:

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

Env: EIGHT_SLEEP_MCP_HOST, EIGHT_SLEEP_MCP_PORT, EIGHT_SLEEP_MCP_TRANSPORT=http.

Local-first MCP server that connects AI agents to your Eight Sleep pod — sleep sessions, temperature program, alarms, adjustable base — with an explicit mutation gate for write actions.

Unofficial project. Not affiliated with, endorsed by, or supported by Eight Sleep, Inc. Eight Sleep is a trademark of its respective owner. Use this only with your own Eight Sleep account.

Eight Sleep does not publish a stable public API. This package talks to the same private endpoints (auth-api.8slp.net, client-api.8slp.net, app-api.8slp.net) the mobile app uses, following the path well documented by upstream community projects (lukas-clarke/eight_sleep, mezz64/pyEight, steipete/eightctl).

Part of Delx Wellness — a registry of local-first wellness MCP connectors.

If this connector helps your agent workflow, please star the repo. Stars make the project easier for other AI builders to discover and help Delx keep shipping local-first wellness infrastructure.

Why this exists

Eight Sleep ships great sleep telemetry — nightly score, presence intervals, tnt, smart-temperature schedule — but it lives inside a closed iOS/Android app with no public API. Bringing it into your agent today means reverse-engineering OAuth, juggling token refresh, normalizing endpoint shapes, and handling timezone quirks.

This package does all of that locally, exposes Eight Sleep through the Model Context Protocol, and lets any MCP-compatible agent read your sleep context (and write pod commands, if you opt in) with one config snippet. Credentials and tokens stay on your machine.

Setup in 60 seconds

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

Then add this to your MCP client config:

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

For Claude Desktop, run setup --client claude and the snippet is written for you.

Try it with your agent

Three things to ask first:

text
Use eight_sleep_connection_status to check setup, then run eight_sleep_get_me.Tell me what device you find.
text
Call eight_sleep_get_trends for the last 7 days, response_format=json.What's my best night and worst night, and why?
text
Call eight_sleep_get_temperature. Summarize the current smart schedule(bedtime, initial sleep, final sleep) and tell me if I should tune it.

Data availability

This package talks to the Eight Sleep mobile-app API. It does not access continuous biometric sensor streams or BLE.

DataToolSource
User & deviceeight_sleep_get_me, eight_sleep_get_user, eight_sleep_get_current_deviceclient-api.8slp.net /users/...
Temperature programeight_sleep_get_temperatureapp-api.8slp.net /v1/users/{id}/temperature
Sleep trendseight_sleep_get_trendsclient-api.8slp.net /users/{id}/trends
Alarmseight_sleep_get_alarmsapp-api.8slp.net /v2/users/{id}/alarms
Adjustable baseeight_sleep_get_baseapp-api.8slp.net /v1/users/{id}/base

Workflow tools

ToolWhat it does
eight_sleep_nightly_summaryMulti-night summary: best night, worst night, mean score, nights under 70 / over 85 — one call instead of post-processing raw get_trends.
eight_sleep_wellness_contextReturns a normalized delx-wellness-context/v1 payload so other Delx Wellness tools (Nourish, Exercise Catalog, Telegram coaches) can read sleep context without knowing the Eight Sleep API.

Mutation tools (write gate)

Off by default. To enable, re-run setup with --allow-mutations or enable EIGHT_SLEEP_ALLOW_MUTATIONS. Do not put the assignment in default MCP snippets.

ActionTool
Set heating leveleight_sleep_set_temperature
Turn side on/offeight_sleep_set_side
Toggle away modeeight_sleep_set_away_mode
Snooze alarmeight_sleep_snooze_alarm
Dismiss alarmeight_sleep_dismiss_alarm

When the gate is off, mutation tools return an explicit mutations disabled error so agents can detect it and ask the user to opt in.

Privacy

  • Credentials stored in ~/.eight-sleep-mcp/config.json with chmod 600.
  • Auth tokens stored in ~/.eight-sleep-mcp/tokens.json with chmod 600.
  • Sensitive fields (email, device serial, shipping address, payment last-four) are redacted from tool responses by default.
  • EIGHT_SLEEP_PRIVACY_MODE:
    • summary — minimal fields only.
    • structured (default) — preserves complete nested sleep fields and future upstream additions while redacting identifiers.
    • raw — full upstream payload (debugging only).

Trend requests validate real YYYY-MM-DD dates, range order and IANA timezone names before any network call.

Call eight_sleep_privacy_audit at any time to inspect the current posture without exposing secrets.

Environment variables

VarPurpose
EIGHT_SLEEP_EMAILAccount email.
EIGHT_SLEEP_PASSWORDAccount password.
EIGHT_SLEEP_ALLOW_MUTATIONSEnable write tools (keep unset in default snippets).
EIGHT_SLEEP_PRIVACY_MODEsummary / structured / raw.
EIGHT_SLEEP_CACHELegacy compatibility key; authenticated response caching is disabled and this value is ignored.
EIGHT_SLEEP_TOKEN_PATHOverride token storage path.
EIGHT_SLEEP_CLIENT_ID / EIGHT_SLEEP_CLIENT_SECRETOverride Android-app credential defaults (advanced).

Stability

Eight Sleep changes mobile-app endpoints without notice. This connector tracks upstream community projects (lukas-clarke/eight_sleep, steipete/eightctl, mezz64/pyEight) for breakage signals. If a tool starts returning 4xx unexpectedly, check those repos and the project issues for the latest known-good shape.

Credits

📧 Contact & Support

License

MIT — see LICENSE.

Skill or MCP

Same package, two doors. MCP registers tools on stdio/HTTP. The skill can drive the same tools through the CLI when the client has no MCP:

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

Copy skill/SKILL.md into your agent skills dir.

來源:README.md,提交 63fc296

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.2.5最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分