oura-ring-mcp — MCP-сервер для Claude Code: функции и запуск
Передаёт данные кольца Oura в диалог с нейросетью. Помогает разбирать показатели сна, индекс готовности и уровень стресса без ручной выгрузки отчётов.
claude mcp add --env OURA_ACCESS_TOKEN=<OURA_ACCESS_TOKEN> --env OURA_CLIENT_ID=<OURA_CLIENT_ID> --env OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> --transport stdio oura-ring-mcp -- npx -y oura-ring-mcpЧто делает oura-ring-mcp
Сервер подключает Oura Ring к ассистентам через протокол MCP. В диалоге становятся доступны готовые показатели: продолжительность фаз сна, баллы восстановления, частота пульса, сатурация SpO2 и потраченные калории. Вместо сырого JSON ассистент отдаёт структурированный текст с пояснением метрик.
Внутри заложены функции поиска аномалий detect_anomalies, сопоставления метрик correlate_metrics и отслеживания динамики вариабельности сердечного ритма analyze_hrv_trend. Можно сравнивать периоды между собой или проверять, как добавленные пользовательские теги влияют на ночной отдых. Сервер поддерживает встроенные ресурсы вроде oura://today и сценарии разбора недели.
Для работы необходим Node.js версии 18 или выше. Авторизоваться можно через личный токен доступа OURA_ACCESS_TOKEN либо настроив приложение OAuth с перенаправлением на адрес http://localhost:3000/callback.
Какие задачи решает
- Оценивать качество сна и длительность фаз без входа в мобильное приложение
- Выявлять отклонения и аномалии в самочувствии за последние дни
- Сравнивать динамику восстановления между рабочими и выходными днями
- Проверять влияние привычек и тегов на ночной пульс и показатель HRV
Примеры запросов агенту
- Как я спал этой ночью и готов ли организм к тяжёлой тренировке?
- Сравни показатели вариабельности пульса за эту неделю с прошлой
- Найди аномалии в моих показателях стресса и активности за последние дни
Как установить oura-ring-mcp
Командой платформы
claude mcp add --env OURA_ACCESS_TOKEN=<OURA_ACCESS_TOKEN> --env OURA_CLIENT_ID=<OURA_CLIENT_ID> --env OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> --transport stdio oura-ring-mcp -- npx -y oura-ring-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add oura-ring-mcp --env OURA_ACCESS_TOKEN=<OURA_ACCESS_TOKEN> --env OURA_CLIENT_ID=<OURA_CLIENT_ID> --env OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> -- npx -y oura-ring-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"oura-ring-mcp": {
"command": "npx",
"args": [
"-y",
"oura-ring-mcp"
],
"env": {
"OURA_ACCESS_TOKEN": "<OURA_ACCESS_TOKEN>",
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"oura-ring-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"oura-ring-mcp"
],
"env": {
"OURA_ACCESS_TOKEN": "<OURA_ACCESS_TOKEN>",
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OURA_ACCESS_TOKEN=<OURA_ACCESS_TOKEN> -e OURA_CLIENT_ID=<OURA_CLIENT_ID> -e OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> oura-ring-mcp npx -y oura-ring-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о oura-ring-mcp
Как установить oura-ring-mcp в Claude Code?
Выполните в терминале команду claude mcp add oura-ring-mcp -e OURA_ACCESS_TOKEN=<OURA_ACCESS_TOKEN> -e OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> -- npx -y oura-ring-mcp, подставив свои ключи доступа к API Oura.
Что делает oura-ring-mcp?
Сервер запрашивает биометрические данные с кольца Oura и передаёт их ассистенту. Он форматирует показатели сна, шагов, стресса и готовности в читаемый текст с поиском корреляций.
Какие варианты авторизации поддерживает сервер?
Доступны два пути: генерация персонального токена в кабинете Oura либо запуск OAuth через команду npx oura-ring-mcp auth с сохранением ключей в ~/.oura-mcp/credentials.json.
