使用说明
@tasque/fitbit mcp
MCP服务器，用于通过Fitbit Web API读取和写入Fitbit健康数据。
工具
阅读
| 工具 | 说明 |
|---|---|
fitbit_connect |
通过OAuth连接Fitbit帐户（打开浏览器） |
fitbit_status |
检查帐户是否已连接以及令牌是否有效 |
fitbit_disconnect |
断开帐户连接并删除存储的令牌 |
fitbit_profile |
获取用户资料信息 |
fitbit_daily_summary |
每日综合概述：活动、睡眠、心率 |
fitbit_sleep |
分阶段的详细睡眠数据 |
fitbit_sleep_range |
日期范围内的睡眠数据 |
fitbit_heart_rate |
休息区人力资源和时间细分 |
fitbit_heart_rate_intraday |
日间心率，间隔1分钟或5分钟 |
fitbit_activity |
日常活动总结 |
fitbit_activity_log |
最近的锻炼/健身课程 |
fitbit_weight |
日期范围的重量日志条目 |
fitbit_spo2 |
血氧（SpO2）数据 |
fitbit_breathing_rate |
呼吸频率数据 |
fitbit_skin_temperature |
皮肤温度变化数据 |
fitbit_food_log |
约会的食物日记 |
fitbit_nutrition_summary |
每日营养总量 |
fitbit_nutrition_timeseries |
日期范围内的营养值 |
fitbit_water |
约会用水 |
fitbit_activity_goals |
每日/每周活动目标 |
fitbit_activity_timeseries |
日期范围内的活动资源 |
fitbit_azm_timeseries |
日期范围内的活动区域分钟数 |
写
写入需要Fitbit应用程序启用写入权限（除了读取权限）。OAuth作用域名称不变(nutrition, activity, weight, sleep)但是 在启用写入之前铸造的现有令牌仍然是只读的 --奔跑 fitbit_disconnect 然后 fitbit_connect 升级应用程序权限后。
| 工具 | 说明 |
|---|---|
fitbit_log_food |
记录食物条目（按食物ID或食物名称+卡路里）。使用膳食类型ID 1=早餐，2=晨间小吃，3=午餐，4=下午小吃，5=晚餐，7=任何时候 |
fitbit_delete_food_log |
按id删除食物日志条目 |
fitbit_log_water |
记录饮水量（ml/fl oz/杯） |
fitbit_delete_water_log |
按id删除水日志条目 |
fitbit_create_food |
在用户的食物数据库中创建自定义食物 |
fitbit_delete_food |
按id删除自定义食物 |
fitbit_set_food_goal |
设定每日卡路里目标（卡路里或强度） |
fitbit_set_water_goal |
设定每日用水目标 |
fitbit_log_activity |
记录已完成的锻炼（持续时间（毫秒）） |
fitbit_delete_activity_log |
按id删除活动日志条目 |
fitbit_set_activity_goal |
设定每日/每周目标（步数、距离、卡路里、楼层、活动分钟数、AZM） |
fitbit_log_weight |
记录重量测量值 |
fitbit_delete_weight_log |
按id删除重量日志条目 |
fitbit_log_body_fat |
记录体脂百分比 |
fitbit_delete_body_fat_log |
按id删除体脂肪日志条目 |
fitbit_set_weight_goal |
设定起始/目标体重目标 |
fitbit_log_sleep |
记录睡眠会话（持续时间（毫秒）） |
fitbit_delete_sleep_log |
按id删除睡眠日志条目 |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
FITBIT_CLIENT_ID |
是 | 来自Fitbit应用程序注册的OAuth客户端ID |
FITBIT_CLIENT_SECRET |
是 | 来自Fitbit应用程序注册的OAuth客户端密钥 |
身份验证设置
- 在以下网址注册Fitbit应用程序 dev.fitbit.com/apps/new 使用OAuth类型“个人”和重定向URL
http://localhost:8977/callback - 集
FITBIT_CLIENT_ID和FITBIT_CLIENT_SECRET环境变量 - 使用
fitbit_connect通过浏览器进行身份验证的工具
令牌被持久化 ~/.config/claude-fitbit-mcp/tokens.json.
发展
npm install
npm run build
npm start # stdio mode
