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 分