我们的mcp
用于的CLI和MCP服务器 欧拉戒指 API v2。从命令行或通过Claude Code/任何MCP客户端查询睡眠、准备状态、活动、心率、压力、SpO2、锻炼和会话数据。
特性
- 命令行界面：查询任何日期的所有Oura数据
- MCP 服务器：10个用于与Claude Code和其他MCP客户端集成的工具
- 认证：支持个人访问令牌和具有自动令牌刷新功能的OAuth2
MCP工具
| 工具 | 说明 |
|---|---|
oura_daily_summary | 睡眠评分、准备度评分、睡眠细节和约会活动 |
oura_sleep | 详细的睡眠时段数据（持续时间、阶段、心率、心率变异性） |
oura_readiness | 准备度得分和贡献者 |
oura_activity | 每日活动数据（步数、卡路里、距离） |
oura_workouts | 自动检测心率、卡路里、持续时间和强度的锻炼 |
oura_heart_rate | 一个时间窗口的连续心率数据 |
oura_stress | 日常压力和恢复水平 |
oura_spo2 | 血氧（SpO2）百分比 |
oura_sessions | 冥想、呼吸和放松课程 |
oura_trends | 多日睡眠和准备度得分趋势 |
作为Claude代码插件安装
claude plugin marketplace add daveremy/oura-mcp
claude plugin install oura-mcp@oura-mcp-plugins然后在插件的env中设置Oura令牌（请参阅下面的Auth）。
设置
1.获取Oura API代币
个人访问令牌（最简单）：
- 去 Oura开发者门户
- 创建新的个人访问令牌
- 保存：
npx @daveremy/oura-mcp config set-token YOUR_TOKEN
令牌存储在 ~/.oura-mcp/config.json 并且可以在任何地方工作——CLI、MCP服务器和Claude Code插件。您还可以设置 OURA_TOKEN 作为环境变量（优先于存储的配置）。
OAuth2（用于自动令牌刷新）：
- 在以下位置创建应用程序 Oura OAuth应用程序
- 将重定向URI设置为
http://localhost:9876/callback - 集
OURA_CLIENT_ID和OURA_CLIENT_SECRET在您的环境中 - 跑
oura auth完成流程
2.用作MCP服务器
无需安装--使用 npx 直接运行：
{
"mcpServers": {
"oura": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@daveremy/oura-mcp"],
"env": {
"OURA_TOKEN": "your_token"
}
}
}
}或通过CLI注册：
claude mcp add oura -- npx -y @daveremy/oura-mcp3.用作CLI
npm install -g @daveremy/oura-mcp
export OURA_TOKEN=your_token
oura sleep # Today's sleep data
oura sleep --date 2026-03-05 # Specific date
oura readiness # Today's readiness
oura activity # Today's activity
oura workouts # Today's workouts
oura stress # Today's stress levels
oura spo2 # Today's blood oxygen
oura sessions # Today's meditation/breathing sessions
oura heart-rate --start 2026-03-05T08:00:00 --end 2026-03-05T09:00:00
oura summary # Everything for today
oura config set-token # Save token to ~/.oura-mcp/config.json
oura config show # Show stored config (masked)
oura config clear # Remove stored credentials所有命令都将JSON输出到stdout。
4.从源头安装
git clone https://github.com/daveremy/oura-mcp.git
cd oura-mcp
npm install
npm run build环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
OURA_TOKEN | 选项A | 个人访问令牌（最简单） |
OURA_ACCESS_TOKEN | 选项B | OAuth2访问令牌 |
OURA_REFRESH_TOKEN | 选项B | OAuth2刷新令牌 |
OURA_CLIENT_ID | 选项B | OAuth2客户端ID |
OURA_CLIENT_SECRET | 选项B | OAuth2客户端机密 |
技能
此插件捆绑了 /oura 会话式健康数据查询技能：
/oura # Today's health briefing
/oura sleep # Detailed sleep data
/oura readiness # Readiness score and contributors
/oura activity # Steps, calories, distance
/oura workouts # Auto-detected workouts
/oura hr # Heart rate for a time window
/oura stress # Stress and recovery levels
/oura spo2 # Blood oxygen
/oura sessions # Meditation/breathing sessions
/oura trends # 7-day sleep + readiness trends
/oura trends 14 # 14-day trends
/oura summary # Full daily summary (same as default)该技能将MCP工具编排成对话式、洞察力驱动的响应，而不是原始JSON。
需求
- Node.js 18+
- 具有API访问权限的Oura环
许可证
麻省理工学院