Fitbit人工智能MCP连接器
    ](https://badge.fury.io/js/mcp-fitbit) ](https://www.npmjs.com/package/mcp-fitbit)
将AI助手连接到您的Fitbit健康数据
让您的AI助手访问您的Fitbit数据，以获得个性化的健康见解、趋势分析和自动跟踪。与Claude Desktop和其他MCP兼容的AI工具配合使用。
它做什么
🏃 锻炼和活动 -获取详细的锻炼日志和活动数据\ 😴 睡眠分析 -检索睡眠模式和质量指标\ ⚖️ 重量追踪 -访问权重随时间的变化趋势\ ❤️ 心率数据 -监测心率模式和区域\ 🍎 营养日志 -检查食物摄入量、卡路里和宏量\ 👤 个人资料信息 -访问Fitbit基本配置文件详细信息
*问你的人工智能一些事情，比如：“本周给我看看我的睡眠模式”或“我锻炼时的平均心率是多少？”*
快速开始
🚀 想立即测试工具吗？
选项1：从npm安装（推荐）
- 使用OAuth 2.0应用程序类型创建应用程序： Personal - 设置回调URL: http://localhost:3000/callback - 注意你的 客户端ID 和 客户端密钥
- 全局安装软件包：
npm install -g mcp-fitbit- 添加到您的Claude Desktop配置文件中：
{
"mcpServers": {
"fitbit": {
"command": "mcp-fitbit",
"args": [],
"env": {
"FITBIT_CLIENT_ID": "your_client_id_here",
"FITBIT_CLIENT_SECRET": "your_client_secret_here"
}
}
}
}- 配置文件位置：
- Windows：%AppData%\\Claude\\Claude_desktop_config json - macOS：~/库/应用程序支持/Claude/Claude_desktop_config json - Linux:~/.config/Claude/Claude_desktop_config json
- 重新启动Claude Desktop并询问您的Fitbit数据！
选项2：开发设置
- 获取Fitbit API证书 （见下文安装）
- 然后运行：
git clone https://github.com/TheDigitalNinja/mcp-fitbit
cd mcp-fitbit
npm install
# Create .env with your Fitbit credentials
npm run dev这两个选项都打开了 MCP检查员 在 http://localhost:5173 在那里，您可以交互式地测试所有工具并处理OAuth流。
安装
面向终端用户（npm包）
- 获取Fitbit API证书 在 dev.fitbit.com
- 集 OAuth 2.0应用程序类型 向 Personal - 集 回调URL 向 http://localhost:3000/callback
- 安装软件包：
npm install -g mcp-fitbit- 创建
.env包目录中的文件：
当你奔跑时 mcp-fitbit 这是第一次，它会告诉你在哪里创建 .env 文件。它看起来像：
C:\Users\YourName\AppData\Roaming\npm\node_modules\mcp-fitbit\.env- 将您的凭据添加到
.env文件：
FITBIT_CLIENT_ID=your_client_id_here
FITBIT_CLIENT_SECRET=your_client_secret_here- 运行服务器：
mcp-fitbit开发者（来源）
- 获取Fitbit API证书 在 dev.fitbit.com
- 集 OAuth 2.0应用程序类型 向 Personal - 集 回调URL 向 http://localhost:3000/callback
- 克隆和设置：
git clone https://github.com/TheDigitalNinja/mcp-fitbit
cd mcp-fitbit
npm install- 创建
.env文件：
FITBIT_CLIENT_ID=your_client_id_here
FITBIT_CLIENT_SECRET=your_client_secret_here- 构建服务器：
npm run build可用工具
| 工具 | 说明 | 参数 |
|---|---|---|
get_weight | 不同时间段的重量数据 | period: 1d, 7d, 30d, 3m, 6m, 1y |
get_sleep_by_date_range | 日期范围的睡眠日志（最多100天） | startDate, endDate （年-月-日） |
get_exercises | 日期后的活动/锻炼日志 | afterDate （YYYY-MM-DD）， limit (1-100) |
get_daily_activity_summary | 每日活动总结及目标 | date （年-月-日） |
get_activity_goals | 用户的活动目标（每日/每周） | period: daily, weekly |
get_activity_timeseries | 活动时间序列数据（最多30天） | resourcePath, startDate, endDate （年-月-日） |
get_azm_timeseries | 活动区分钟时间序列（最多1095天） | startDate, endDate （年-月-日） |
get_heart_rate | 一段时间内的心率 | period: 1d, 7d, 30d, 1w, 1m，可选 date |
get_heart_rate_by_date_range | 日期范围内的心率（最多1年） | startDate, endDate （年-月-日） |
get_food_log | 一天的完整营养数据 | date （YYYY-MM-DD或“今天”） |
get_nutrition | 随着时间的推移，个体营养素 | resource, period，可选 date |
get_nutrition_by_date_range | 日期范围内的个体营养素 | resource, startDate, endDate |
get_profile | 用户资料信息 | 无 |
营养资源： caloriesIn, water, protein, carbs, fat, fiber, sodium
活动时间序列资源： steps, distance, calories, activityCalories, caloriesBMR, tracker/activityCalories, tracker/calories, tracker/distance
克劳德桌面
使用npm包（推荐）：
增添 claude_desktop_config.json:
{
"mcpServers": {
"fitbit": {
"command": "mcp-fitbit",
"args": []
}
}
}使用本地开发版本：
增添 claude_desktop_config.json:
{
"mcpServers": {
"fitbit": {
"command": "node",
"args": ["C:\\path\\to\\mcp-fitbit\\build\\index.js"]
}
}
}配置文件位置：
- 窗户：
%AppData%\Claude\claude_desktop_config.json - macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json
首次运行授权
当你第一次要求你的AI助手使用Fitbit数据时：
- 服务器打开您的浏览器
http://localhost:3000/auth - 登录Fitbit并授予权限
- 您将被重定向到成功页面
- 您的AI现在可以访问您的Fitbit数据！
发展
npm run lint # Check code quality
npm run format # Fix formatting
npm run build # Compile TypeScript
npm run dev # Run with MCP inspector架构： 看 TASKS.md 了解改进机会和技术细节。