Withings Mcp Unofficial

本地服务

wellness.delx.ai健康医疗53 周前更新

代码仓库访问官网

关于 Withings Mcp Unofficial

Withings Mcp Unofficial 是面向处理个人 Withings 健康数据的 Agent 的本地优先 MCP 服务。它在本机处理 OAuth，并提供身体测量、活动、睡眠和心脏记录的结构化访问，原始响应可选。

主要功能

01访问身体测量数据
02获取活动与锻炼记录
03读取睡眠摘要和详情
04按设备情况访问心脏记录
05选择结构化或原始数据

适用场景

01查看每日健康测量数据
02比较每周睡眠和活动
03调查身体成分与睡眠趋势
04将个人 Withings 数据接入 Agent

MCP 相关

通过 MCP 工具、提示词和资源提供 Withings 数据，包括身体、活动、睡眠和心脏记录。默认使用 stdio，也可在本地回环地址上使用无状态 Streamable HTTP。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y withings-mcp-unofficial

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmwithings-mcp-unofficialstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
response_format	enum	否	markdown \| json

详细介绍

Withings MCP

让你的 AI Agent 在本地获取 Withings 身体测量、睡眠、活动和心脏数据 —。
本地优先的 MCP 服务 — 令牌绝不会离开你的设备。

⚡ 使用 Delx Wellness for Hermes 一键安装： npx -y delx-wellness-hermes setup — 在专用的 Hermes 配置中预先配置此连接器及其他 8 个连接器。

也可以将它单独接入 Claude Desktop / Cursor / ChatGPT Desktop — 请参阅下方的安装部分。

HTTP（v2 无状态）

默认使用 stdio。可选 Streamable HTTP — 无会话 ID，返回 JSON 响应，仅限环回地址：

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

环境变量：WITHINGS_MCP_HOST、WITHINGS_MCP_PORT、WITHINGS_MCP_TRANSPORT=http。

本地优先的 MCP 服务，将 AI Agent 连接到你的 Withings 身体、睡眠、活动和心脏数据。

非官方项目。 与 Withings 无关联，未获其认可或支持。Withings 是其各自所有者的商标。请仅将此项目用于你自己的 Withings 账户，并遵守 Withings 公共 API 条款。

由 David Mosiah 为使用 Claude、Cursor、Hermes、OpenClaw 或其他兼容 MCP 的 Agent 来分析身体成分、睡眠和长期健康趋势的人打造 — 无需从 Withings 应用复制粘贴数据。

这是 Delx Wellness 的一部分；Delx Wellness 是本地优先健康类 MCP 连接器的注册目录。

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

为什么会有这个项目

Withings 拥有运营时间最长的消费级身体成分与睡眠生态系统（智能体重秤、Sleep Analyzer、ScanWatch）。这些数据非常丰富，包括定时测量的体重、体脂和肌肉量、睡眠阶段以及达到 ECG 级别的心脏记录，但 Withings Public API 使用签名令牌 OAuth 流程，比大多数消费级 API 更复杂。

此软件包会在本地处理签名 OAuth 流程、规范化响应，并通过模型上下文协议提供 Withings 服务。令牌不会离开你的设备。默认启用隐私模式，原始负载需选择后才会提供。

60 秒内完成设置

你需要一个 Withings 应用（在此创建），其重定向 URI 为 http://127.0.0.1:3000/callback。

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

推荐的权限范围：

user.activity user.metrics

然后将以下内容添加到 MCP 客户端配置中：

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

对于 Claude Desktop，运行 setup --client claude，系统会为你写入配置片段。

注意： Withings OAuth 授权码的有效期很短（几分钟）。请勿在批准授权页面后暂停，以免 withings_exchange_code 无法及时运行。

与你的 Agent 一起试用

先问这三个问题：

Use withings_connection_status to check setup, then run withings_daily_summary.
Give me a 5-line wellness brief for today.

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

Use the withings_body_sleep_investigation prompt, after=2026-04-01.
Walk me through what changed in body composition + sleep.

数据可用性

此软件包使用官方 Withings Public API。本 README 中的 raw 指受支持端点返回的 Withings 上游 JSON，而非设备传感器原始数据流。

数据	是否可用	备注
身体测量数据（体重、体脂率、肌肉、骨骼、水分）	✓	需要 `user.metrics` 权限范围
每日活动（步数、卡路里、距离、强度）	✓	需要 `user.activity` 权限范围
锻炼记录 + 运动元数据	✓	需要 `user.activity` 权限范围
睡眠摘要（时长、阶段、效率、心率）	✓	需要 `user.activity` 权限范围
睡眠详细记录	✓	设备支持时可用
心脏记录（ECG、血压等）	✓	需要 `user.metrics` 权限范围；具体情况因设备/套餐而异
连续传感器遥测数据	—	Withings Public API 不提供

工具

从这些工具开始：

withings_connection_status — 在调用 Withings 前验证本地设置
withings_data_inventory — 列出支持的数据领域、权限范围、隐私模式和建议的首次调用，不调用 Withings API。
withings_daily_summary — 今日身体、睡眠、活动和心脏状况简报
withings_weekly_summary — 评分卡、与上周的比较以及下周计划

身份验证与诊断

withings_capabilities、withings_agent_manifest、withings_privacy_audit、withings_cache_status
withings_get_auth_url、withings_exchange_code、withings_revoke_access

身体与指标

withings_list_body_measures — 定时测量的体重/成分记录。对于较长的历史记录，使用 after / before，格式为 YYYY-MM-DD 或 ISO 8601；服务会向上游发送 Withings startdate / enddate（Unix 秒），并通过 limit 限制返回的记录数。
日期筛选会根据操作类型调整：getactivity / getworkouts / 睡眠 getsummary 会发送民用日期格式的 startdateymd / enddateymd；getmeas、睡眠详细数据和心脏记录列表则继续使用纪元时间格式的 startdate / enddate。对于使用纪元时间的操作，带偏移量的 ISO 时间点会保留精确的纪元转换结果。
withings_list_heart — 设备/套餐允许时获取心脏记录

活动

withings_list_activity — 每日活动摘要
withings_list_workouts — 已记录的锻炼

睡眠

withings_list_sleep_summary — 每日睡眠摘要，包含心率/阶段字段
withings_list_sleep — 睡眠详细记录

提示词

withings_daily_checkin — 实用的每日健康与身体状况检查
withings_weekly_review — 回顾身体、睡眠和活动趋势
withings_body_sleep_investigation — 综合调查身体测量数据与睡眠情况

资源

withings://capabilities、withings://agent-manifest
withings://latest/activity、withings://latest/sleep
withings://summary/daily、withings://summary/weekly

隐私与安全

OAuth 令牌存储在 ~/.withings-mcp/tokens.json 中，权限为 0600，且工具绝不会返回这些令牌。
Withings 使用签名请求 OAuth 流程——软件包会在本地处理签名；客户端密钥不会传给 MCP 客户端。
服务绝不会打印访问令牌或刷新令牌。
WITHINGS_PRIVACY_MODE 默认为 structured。只有选择 raw 模式或按调用覆盖设置时，才会返回原始 Withings JSON。
结构化模式会保留完整的上游生理字段（包括 Withings 今后新增的字段），同时移除 GPS 和包含机密的值。
withings_revoke_access 会清除本地令牌；能否在账户端完全撤销令牌取决于你的 Withings 套餐。
MCP 客户端不会看到访问令牌或刷新令牌。
这不是医疗建议。Withings 会提供可能类似医疗信号的数据（ECG、血压），但此服务用于个人 AI 工作流，而非诊断或治疗。

配置

setup 会将其中大多数配置写入 ~/.withings-mcp/config.json（权限为 0600）。支持手动使用环境变量覆盖：

WITHINGS_CLIENT_ID=…
WITHINGS_CLIENT_SECRET=…
WITHINGS_REDIRECT_URI=http://127.0.0.1:3000/callback

# Optional
WITHINGS_SCOPES="user.activity user.metrics"
WITHINGS_PRIVACY_MODE=structured        # summary | structured | raw
WITHINGS_CACHE=sqlite                   # optional read-through cache
WITHINGS_TOKEN_PATH=~/.withings-mcp/tokens.json
WITHINGS_CACHE_PATH=~/.withings-mcp/cache.sqlite

Hermes / 远程设置

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

更改 Hermes 配置后，使用 /reload-mcp 或 hermes mcp test withings。正常访问数据时无需重启网关。

如果浏览器 OAuth 必须在与 Hermes 不同的机器上完成，请在本地运行 auth，然后将 ~/.withings-mcp/tokens.json 复制到服务器，并执行 chmod 600。

要求

Node.js 20+
一个 Withings 应用，位于 https://account.withings.com/partner/dashboard_oauth2，其重定向 URI 为 http://127.0.0.1:3000/callback

开发

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

使用 MCP Inspector 进行测试：

npx @modelcontextprotocol/inspector node dist/index.js

链接

npm：https://www.npmjs.com/package/withings-mcp-unofficial
文档站点：https://wellness.delx.ai/connectors/withings
旧版文档：https://withingsmcp.vercel.app/
GitHub：https://github.com/davidmosiah/withings-mcp
Delx Wellness 注册表：https://github.com/davidmosiah/delx-wellness
连接器质量标准：https://github.com/davidmosiah/delx-wellness/blob/main/docs/connector-quality-standard.md
Withings 公共 API 文档：https://developer.withings.com/api-reference/

另请参阅

完整的 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`	fitbitmcp
Withings	`withings-mcp-unofficial`	withings-mcp
Apple Health	`apple-health-mcp-unofficial`	apple-health-mcp
Polar	`polar-mcp-unofficial`	polarmcp
Nourish（营养）	`wellness-nourish`	wellness-nourish

Hermes 一键设置——预配置上述所有连接器以及 wellness 技能 + 入门引导：delx-wellness-hermes。

📧 联系与支持

📨 [email protected] — 一般问题、集成帮助、合作事宜
🐛 错误报告 / 功能请求 — GitHub Issues
🐦 更新动态 — X 上的 @delx369
🌐 网站 — wellness.delx.ai

许可证

MIT — 参见 LICENSE。

免责声明

本软件按原样提供。它不是医疗器械，不提供医疗建议，也不应用于诊断或治疗。Withings 提供的数据可能类似医疗信号（心电图、血压、身体成分）——如有医疗方面的顾虑，请务必咨询合格的专业人士。

Skill 或 MCP

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

npx -y withings-mcp-unofficial call withings_connection_status --json '{}'

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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。