Oura MCP server

Oura MCP server

Получайте данные кольца Oura из Claude.ai и Claude Code: сон — с полными периодами, из которых складывается оценка, готовность, активность, тренировки, пульс, стресс, SpO2, устойчивость, сердечно-сосудистый возраст, VO2 max, рекомендации по времени сна, теги и режим отдыха. Сервер работает с документированным Oura API v2, а перед ним находится вход через OAuth 2.1, так что вы можете добавить его в Claude.ai как кастомный коннектор. Claude Code может использовать обычный токен.

Почему не npm-пакет

Сначала это было обёрткой над @daveremy/oura-mcp, а затем она заменила исходный пакет, потому что тот не возвращает ничего на большую часть запросов. Такие пакеты запрашивают диапазон из одного дня как start_date == end_date, а Oura API отвечает на такие запросы не так, как можно было бы ожидать по названию:

• sleep фильтрует по bedtime_start в UTC, поэтому ночь, начавшаяся в 00:31 по местному времени (UTC+3), попадает на предыдущий 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

Получите токен Oura на странице cloud.ouraring.com.

Затем подставьте YOUR_USER и имя хоста в systemd/*.service и nginx/oura-mcp.conf, и:

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 должен возвращать метаданные, а /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: Настройки, Коннекторы, Добавить кастомный коннектор, 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.