Skip to content
Back to search

MCP-oura

MCP server for Oura API integration

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yuzehao2023--mcp-oura/badge.svg)](/listings/yuzehao2023--mcp-oura)

HTML

<a href="/listings/yuzehao2023--mcp-oura"><img src="/api/listings/yuzehao2023--mcp-oura/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 140 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Oura MCP Server
  2. [简体中文](./README_zh_CN.md) | English | 한국어
  3. ![Python Package](https://github.com/tomekkorbak/oura-mcp-server/workflows/Python%20Package/badge.svg)
  4. [![PyPI version](https://badge.fury.io/py/oura-mcp-server.svg)](https://badge.fury.io/py/oura-mcp-server)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  6. [![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/release/python-3120/)
  7. A [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that provides access to the Oura API. It allows language models to query sleep, readiness, and resilience data from Oura API.
  8. <a href="https://glama.ai/mcp/servers/@YuzeHao2023/MCP-oura">
  9. <img width="380" height="200" src="https://glama.ai/mcp/servers/@YuzeHao2023/MCP-oura/badge" alt="Oura Server MCP server" />
  10. </a>
  11. ## All Documents
  12. > Call for translators! [We're looking for translators](https://github.com/YuzeHao2023/MCP-oura/issues/5) to help translate this spec for everyone!
  13. **Read our documentation in the following languages:**
  14. | Language | Link |
  15. | -------- | --------------------------------------------------------------- |
  16. | English | [English](https://github.com/YuzeHao2023/MCP-oura/README.md) |
  17. | 中文 | [中文](https://github.com/YuzeHao2023/MCP-oura/README_zh_CN.md) |
  18. | 한국어 | [한국어](https://github.com/YuzeHao2023/MCP-oura/README_ko.md) |
  19. ## Available Tools
  20. The server exposes the following tools:
  21. ### Date Range Queries
  22. - `get_sleep_data(start_date: str, end_date: str)`: Get sleep data for a specific date range
  23. - `get_readiness_data(start_date: str, end_date: str)`: Get readiness data for a specific date range
  24. - `get_resilience_data(start_date: str, end_date: str)`: Get resilience data for a specific date range
  25. Dates should be provided in ISO format (`YYYY-MM-DD`).
  26. ### Today's Data Queries
  27. - `get_today_sleep_data()`: Get sleep data for today
  28. - `get_today_readiness_data()`: Get readiness data for today
  29. - `get_today_resilience_data()`: Get resilience data for today
  30. ## Usage
  31. You'll need an Oura API token to use this server. You can obtain one by:
  32. 1. Going to the [Oura Developer Portal](https://cloud.ouraring.com/v2/docs)
  33. 2. Creating a Personal Access Token
  34. ### Claude for Desktop
  35. Update your `claude_desktop_config.json` (located in `~/Library/Application\ Support/Claude/claude_desktop_config.json` on macOS and `%APPDATA%/Claude/claude_desktop_config.json` on Windows) to include the following
  36. ```json
  37. {
  38. "mcpServers": {
  39. "oura": {
  40. "command": "uvx",
  41. "args": ["oura-mcp-server"],
  42. "env": {
  43. "OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
  44. }
  45. }
  46. }
  47. }
  48. ```
  49. ## Example Queries
  50. Once connected, you can ask Claude questions like:
  51. - "What's my sleep score for today?"
  52. - "Show me my readiness data for the past week"
  53. - "How was my sleep from January 1st to January 7th?"
  54. - "What's my resilience score today?"
  55. ## Error Handling
  56. The server provides human-readable error messages for common issues:
  57. - Invalid date formats
  58. - API authentication errors
  59. - Network connectivity problems
  60. ## License
  61. This project is licensed under the MIT License - see the LICENSE file for details.
  62. ---
  63. ## Maintainer
  64. <div align="center">
  65. <h4 align="center">
  66. Maintainers oversee the project's maintenance, decision-making, and long-term development.
  67. </h4>
  68. <!-- 替换以下占位符为实际维护者信息 -->
  69. <a href="https://github.com/YuzeHao2023" target="_blank">
  70. <img src="https://github.com/YuzeHao2023.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="YuzeHao2023" />
  71. </a>
  72. <a href="https://github.com/dvlan26" target="_blank">
  73. <img src="https://github.com/dvlan26.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="dvlan26" />
  74. </a>
  75. <!-- 如需添加更多维护者,复制上方a标签块并修改信息即可 -->
  76. </div>
  77. ## Core Contributors
  78. <div align="center">
  79. <h4 align="center">
  80. The core contributors are the cornerstone of the project.
  81. </h4>
  82. <a href="https://github.com/YuzeHao2023" target="_blank">
  83. <img src="https://github.com/YuzeHao2023.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="YuzeHao2023" />
  84. </a>
  85. <a href="https://github.com/dvlan26" target="_blank">
  86. <img src="https://github.com/dvlan26.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="dvlan26" />
  87. </a>
  88. <a href="https://github.com/halamji" target="_blank">
  89. <img src="https://github.com/halamji.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="halamji" />
  90. </a>
  91. <a href="https://github.com/yzhao112" target="_blank">
  92. <img src="https://github.com/yzhao112.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="yzhao112" />
  93. </a>
  94. <a href="https://github.com/punkpeye" target="_blank">
  95. <img src="https://github.com/punkpeye.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="punkpeye" />
  96. </a>
  97. <a href="https://github.com/iMilesHo" target="_blank">
  98. <img src="https://github.com/iMilesHo.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="iMilesHo" />
  99. </a>
  100. <a href="https://github.com/Vtwonine" target="_blank">
  101. <img src="https://github.com/Vtwonine.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="Vtwonine" />
  102. </a>
  103. <a href="https://github.com/jillhuang69" target="_blank">
  104. <img src="https://github.com/jillhuang69.png" width="100" height="100" style="border-radius: 50%; margin: 0 10px; object-fit: cover;" alt="jillhuang69" />
  105. </a>
  106. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.