Oura MCP server

Oura MCP server

从 Claude.ai 和 Claude Code 读取你的 Oura 戒指：睡眠数据（含评分背后的完整睡眠时段）、准备度、活动、锻炼、心率、压力、SpO2、恢复力、心血管年龄、VO2 max 就寝建议、标签和休息模式。它能对接有文档的 Oura API v2，并在前方加一层 OAuth 2.1 登录，这样你可以将其作为自定义连接器添加到 Claude.ai。Claude Code 则可以直接使用普通 token。

为什么不用 npm 包

这个项目最初是对 @daveremy/oura-mcp 的封装，后来它被替换掉了，因为那个包对你提出的多数请求都不返回任何结果。它以 start_date == end_date 的方式查询单日范围，而 Oura API 不会按照名称所暗示的方式处理这些查询：

• sleep 按 UTC 时区的 bedtime_start 进行过滤，所以一个在本地时间（UTC+3）00:31 开始的夜晚会落在前一个 UTC 日期，从而被排除在天当日的窗口之外

• daily_activity 和 workout 把 end_date 视作开区间，这使得同一天的范围变成零宽度

结果是“静默的”：在每次单日查询中，oura_sleep 返回一个带有空 periods 数组的评分，oura_activity 返回 null，而 oura_workouts 返回 []。没有任何报错，所以看起来像是“没有记录数据”而不是“查询方式有误”。

此服务器会在范围两端各扩展，再按每条记录自身的 day 字段过滤回来，这样在时区上是对的；并且它会不断传入 next_token 直到取完所有数据，而不是只返回一页就默默结束。

工具

每个按日期查询的工具都接受可选的 date 参数（格式为 YYYY-MM-DD），默认为今天。Oura 会把一晚的数据记为醒来当天的数据。

oura_vo2_max、oura_sleep_time 和 oura_cardiovascular_age 本身是稀疏型数据：Oura 是定期计算而不是每天计算，因此返回空结果是正常的，并不是同步失败。

结构

Claude.ai / Claude Code
        |  HTTPS
   Cloudflare Tunnel, or any proxy that gives you HTTPS
        |
   nginx  127.0.0.1:8441
        |
   auth-server.js  :8442    handles the login and the tokens
        |
   oura-mcp  :8440          streamable HTTP, local only
        |
   api.ouraring.com

端口使用 8440-8442，因此不会和同主机上的其他 MCP 冲突。:8440 端口上的服务器本身没有登录保护，而且只允许绑定到 loopback，因此它只能经过登录层来访问节点访问。

设置

需要 Python 3.12 或更高版本，以及用于登录层的 Node。

python3 -m venv .venv
.venv/bin/pip install -e .
npm install --omit=dev

mkdir -p ~/.config/oura-mcp && chmod 700 ~/.config/oura-mcp
echo "OURA_TOKEN=your-personal-access-token" > ~/.config/oura-mcp/env
chmod 600 ~/.config/oura-mcp/env

CONFIG_DIR=~/.config/oura-mcp node set-password.js 'your-password-here'
openssl rand -hex 32 > ~/.config/oura-mcp/token
chmod 600 ~/.config/oura-mcp/token

从 cloud.ouraring.com 获取 Oura token。

然后在 systemd/*.service 和 nginx/oura-mcp.conf 中对应填写 YOUR_USER 和主机名，然后运行：

sudo cp systemd/*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now oura-mcp oura-mcp-auth
sudo cp nginx/oura-mcp.conf /etc/nginx/sites-enabled/oura-mcp
sudo nginx -t && sudo systemctl reload nginx

将隧道或 HTTPS 代理指向 127.0.0.1:8441。OAuth 需要 HTTPS。

从外部检查：discovery 应返回元数据，而没有 token 的 /mcp 必须返回 401。

curl https://your-host/.well-known/oauth-authorization-server
curl -o /dev/null -w '%{http_code}\n' -X POST https://your-host/mcp

连接

Claude.ai：Settings → Connectors → Add custom connector，填写 https://your-host/mcp，client ID 和 secret 留空。

Claude Code：

claude mcp add --transport http oura https://your-host/mcp \
  --header "Authorization: Bearer $(cat ~/.config/oura-mcp/token)" --scope user

改为通过 stdio 运行，不使用任何登录层：

OURA_TOKEN=your-token .venv/bin/oura-mcp

致谢

登录层来自 rollecode/obsidian-remote-mcp。