Fitbit Mcp Unofficial

Name: Fitbit Mcp Unofficial
Author: davidmosiah

本地服务

github.com/davidmosiah健康医疗55 天前更新

代码仓库

关于 Fitbit Mcp Unofficial

Fitbit Mcp Unofficial 是本地优先的 MCP 服务，让 MCP 客户端查询经授权的 Fitbit 活动、睡眠、心率及身体数据。它在本机处理 OAuth，并默认使用结构化隐私模式。

主要功能

01查询活动、睡眠和心率数据
02获取 HRV、血氧及呼吸率数据
03查看体重、饮食和饮水记录
04本地 OAuth 与令牌存储
05结构化隐私模式和原始数据选项

适用场景

01汇总每日活动与睡眠情况
02比较每周活动和睡眠趋势
03调查某日的日内心率数据

MCP 相关

MCP 服务通过 stdio 或可选的无状态 HTTP 向客户端提供 Fitbit 数据工具、提示词和资源。

配置

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

mcp.json · 通用配置

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

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

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

安装包

npmfitbit-mcp-unofficialstdio

工具

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

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

详细介绍

Fitbit MCP

让你的 AI Agent 在本地获取 Fitbit 活动、睡眠、心率和 HRV 数据。
本地优先的 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 fitbit-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

环境变量：FITBIT_MCP_HOST、FITBIT_MCP_PORT、FITBIT_MCP_TRANSPORT=http。

本地优先的 MCP 服务，可将 AI Agent 接入 Fitbit 活动、睡眠、心率、HRV、SpO2 和体重数据。

非官方项目。 与 Fitbit 或 Google 没有关联，也未获其认可或支持。仅将此项目用于你自己的 Fitbit 账户，并遵守 Fitbit Web API 条款。

平台迁移风险： Fitbit 正在迁移至 Google Health API。OAuth、基础 URL、权限范围和重新连接流程可能会在 2026 年发生变化。请将任何故障视为平台变更，并在报告 Bug 前查阅 Fitbit Web API 文档。

由 David Mosiah 为使用 Claude、Cursor、Hermes、OpenClaw 或其他兼容 MCP 的 Agent 来分析活动、睡眠和心脏健康状况的人们打造，无需从 Fitbit 应用中复制粘贴数据。

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

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

存在的原因

Fitbit（现归 Google 所有）积累了多年的穿戴设备数据，包括每日活动、睡眠阶段、日内心率、HRV、SpO2、呼吸频率、体重、饮食和饮水记录。但它的 API 使用 OAuth 2.0，需按权限范围授权，且日内数据的访问权限因应用而异；同时，该平台正在迁移至 Google Health API。

此软件包在本地处理 OAuth 授权流程、规范化响应，并通过 Model Context Protocol 提供 Fitbit。令牌不会离开你的设备。隐私模式默认要求你主动选择，才会提供原始载荷。

60 秒内完成设置

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

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

建议使用以下权限范围：

activity heartrate profile settings sleep weight nutrition

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

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

对于 Claude Desktop，运行 setup --client claude，即可自动为你写入配置片段。

与你的 Agent 试用

先问以下三个问题：

Use fitbit_connection_status to check setup, then run fitbit_daily_summary.
Give me a 5-line operating brief for today.

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

Use the fitbit_intraday_investigation prompt for date=today, detail_level=1min.
Don't claim anything Fitbit can't actually prove.

数据可用性

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

数据	可用性	备注
每日活动（步数、卡路里、距离、心率区间）	✓	标准活动摘要
活动日志	✓	已记录的锻炼
睡眠 + 睡眠阶段	✓	Fitbit 返回阶段数据时可用
静息心率 + 每日心率区间	✓	所有已评分的日期
日内心率样本	有条件	仅当 Fitbit 应用/API 允许访问日内数据时可用
HRV（夜间）	✓	设备/账户支持时可用
SpO2（夜间）	✓	设备/账户支持时可用
呼吸频率	✓	设备/账户支持时可用
体重 + 身体成分	✓	有记录时可用
饮食 + 饮水记录	✓	有记录时可用
设备连续遥测数据	—	Fitbit 的公开 API 不提供

工具

从这些工具开始：

fitbit_connection_status — 在调用 Fitbit 前验证本地设置
fitbit_data_inventory — 列出支持的数据领域、权限范围、隐私模式和建议的首次调用，不会调用 Fitbit API。
fitbit_daily_summary — 汇总今日的准备度、活动、睡眠和心脏相关信息
fitbit_weekly_summary — 提供评分卡、与前一周的比较及下周计划

授权与诊断

fitbit_capabilities、fitbit_agent_manifest、fitbit_privacy_audit、fitbit_cache_status
fitbit_get_auth_url、fitbit_exchange_code、fitbit_revoke_access

个人资料与设备

fitbit_get_profile、fitbit_list_devices

活动

fitbit_get_activity_day、fitbit_list_activities、fitbit_get_activity
列表调用接受 after 或 before，符合 Fitbit 互斥的游标约定。带时区偏移的 ISO 输入会保留其书写的日历日期；无效游标会在发起 HTTP 请求前被拒绝。

睡眠

fitbit_get_sleep_day、fitbit_list_sleep

心脏与生理指标（每个工具都接受一个 date）

fitbit_get_heart_day、fitbit_heart_series、fitbit_get_heart_intraday
fitbit_get_hrv_day、fitbit_get_spo2_day、fitbit_get_breathing_rate_day

身体与营养（每个工具都接受一个 date）

fitbit_get_weight_day、fitbit_get_food_day、fitbit_get_water_day

提示词

fitbit_daily_checkin — 实用的每日健康与活动检查
fitbit_weekly_review — 回顾活动、睡眠和心脏相关信息的趋势
fitbit_intraday_investigation — 调查某一天的日内心率样本

资源

fitbit://capabilities、fitbit://agent-manifest
fitbit://summary/daily、fitbit://summary/weekly

隐私与安全

OAuth 令牌以 0600 权限存储在 ~/.fitbit-mcp/tokens.json 中，工具绝不会返回这些令牌。
服务绝不会打印访问令牌或刷新令牌。
FITBIT_PRIVACY_MODE 默认为 structured。只有选择 raw 模式或在单次调用中覆盖设置时，才会返回 Fitbit 原始 JSON。
结构化模式会保留完整的上游生理记录和响应元数据，同时移除 GPS 和包含机密信息的字段。
健康数据很敏感 — 请勿公开粘贴原始负载。
这不是医疗建议。该服务仅为个人 AI 工作流提供经用户授权的数据，不用于诊断或治疗。

配置

setup 会将其中大部分配置写入 ~/.fitbit-mcp/config.json（0600）。支持通过环境变量手动覆盖：

FITBIT_CLIENT_ID=…
FITBIT_CLIENT_SECRET=…
FITBIT_REDIRECT_URI=http://127.0.0.1:3000/callback

# Optional
FITBIT_SCOPES="activity heartrate profile settings sleep weight nutrition"
FITBIT_PRIVACY_MODE=structured        # summary | structured | raw
FITBIT_CACHE=sqlite                   # retained setting; authenticated payload cache/fallback disabled

经过身份验证的响应不会使用负载缓存或离线回退。现有 SQLite 条目会保留，不会在缓存状态检查中被读取或删除；错误会向上传播。匿名 HTTP 缓存仍可使用。

Hermes / 远程配置

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

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

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

要求

Node.js 20+
一个 Fitbit 应用：https://dev.fitbit.com/apps，其重定向 URI 为 http://127.0.0.1:3000/callback
访问日内心率数据要求 Fitbit 应用获准访问日内数据（因应用而异）

开发

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

使用 MCP Inspector 进行测试：

npx @modelcontextprotocol/inspector node dist/index.js

链接

npm：https://www.npmjs.com/package/fitbit-mcp-unofficial
文档站点：https://wellness.delx.ai/connectors/fitbit
旧版文档：https://fitbitmcp.vercel.app/
GitHub：https://github.com/davidmosiah/fitbit-mcp
Delx Wellness 注册表：https://github.com/davidmosiah/delx-wellness
连接器质量标准：https://github.com/davidmosiah/delx-wellness/blob/main/docs/connector-quality-standard.md
Fitbit Web API：https://dev.fitbit.com/build/reference/web-api/

另请参阅

完整的 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`	fitbit-mcp
Withings	`withings-mcp-unofficial`	withingsmcp
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。

免责声明

本软件按原样提供。它不是医疗器械，不提供医疗建议，也不应用于诊断或治疗。Fitbit 正在迁移到 Google Health API；集成边界可能会发生变化。有关医疗问题，请务必咨询合格的专业人士。

Skill 或 MCP

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

npx -y fitbit-mcp-unofficial call fitbit_connection_status --json '{}'

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

支持 Markdown

登录后评论

第一次接触 MCP？

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

阅读入门指南

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