eight-sleep-mcp

Eight Sleep MCP

将 Eight Sleep 的睡眠趋势、温度计划和闹钟交给你的 AI Agent — 还可选择让它在夜间调整 pod。
本地优先的 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。

本地优先的 MCP 服务，可将 AI Agent 连接到你的 Eight Sleep pod — 睡眠时段、温度计划、闹钟、可调节底座 — 并对写入操作设置明确的变更门控。

非官方项目。 与 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 连接器目录。

如果此连接器对你的 Agent 工作流有所帮助，请为仓库点个星。星标能让其他 AI 构建者更容易发现这个项目，并帮助 Delx 持续交付本地优先的健康基础设施。

存在的原因

Eight Sleep 提供出色的睡眠数据监测，包括每晚评分、在床时间段、tnt 和智能温度计划，但这些数据都封闭在 iOS/Android 应用中，没有公开 API。如今，要将这些数据接入你的 Agent，就得逆向分析 OAuth、处理令牌刷新、规范化各个端点的数据结构，还要应对时区问题。

这个软件包会在本地处理所有这些工作，通过 Model Context Protocol 提供 Eight Sleep 服务，让任何兼容 MCP 的 Agent 都能通过一段配置读取你的睡眠信息（如果你选择启用，也能发送床垫指令）。凭据和令牌始终保留在你的设备上。

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，即可自动为你写入配置片段。

用你的 Agent 试试看

先问这三个问题：

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 错误，方便 Agent 检测并询问用户是否选择启用。

隐私

• 凭据存储在 ~/.eight-sleep-mcp/config.json 中，权限为 chmod 600。
• 身份验证令牌存储在 ~/.eight-sleep-mcp/tokens.json 中，权限为 chmod 600。
• 默认情况下，工具响应会对敏感字段（电子邮件、设备序列号、收货地址、支付卡号末四位）进行脱敏。
• 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] — 一般问题、集成帮助、合作事宜
• 🐛 Bug 报告 / 功能请求 — GitHub 问题
• 🐦 最新动态 — X 上的 @delx369
• 🌐 网站 — wellness.delx.ai

许可证

MIT — 详见 LICENSE。

Skill 或 MCP

同一个软件包，两种使用方式。MCP 会通过 stdio/HTTP 注册工具。当客户端不支持 MCP 时，skill 可通过 CLI 驱动相同的工具：

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

将 skill/SKILL.md 复制到你的 Agent 技能目录。