# MCP Oura

> MCP server for Oura API integration

- **Type:** MCP server
- **Install:** `agentstack add mcp-yuzehao2023-mcp-oura`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [YuzeHao2023](https://agentstack.voostack.com/s/yuzehao2023)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [YuzeHao2023](https://github.com/YuzeHao2023)
- **Source:** https://github.com/YuzeHao2023/MCP-oura

## Install

```sh
agentstack add mcp-yuzehao2023-mcp-oura
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Oura MCP Server

[简体中文](./README_zh_CN.md) | English | 한국어

[](https://badge.fury.io/py/oura-mcp-server)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/release/python-3120/)

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.
 

  

## All Documents

> Call for translators! [We're looking for translators](https://github.com/YuzeHao2023/MCP-oura/issues/5) to help translate this spec for everyone!

**Read our documentation in the following languages:**

| Language | Link                                                            |
| -------- | --------------------------------------------------------------- |
| English  | [English](https://github.com/YuzeHao2023/MCP-oura/README.md)    |
| 中文     | [中文](https://github.com/YuzeHao2023/MCP-oura/README_zh_CN.md) |
| 한국어   | [한국어](https://github.com/YuzeHao2023/MCP-oura/README_ko.md) |

## Available Tools

The server exposes the following tools:

### Date Range Queries

- `get_sleep_data(start_date: str, end_date: str)`: Get sleep data for a specific date range
- `get_readiness_data(start_date: str, end_date: str)`: Get readiness data for a specific date range
- `get_resilience_data(start_date: str, end_date: str)`: Get resilience data for a specific date range

Dates should be provided in ISO format (`YYYY-MM-DD`).

### Today's Data Queries

- `get_today_sleep_data()`: Get sleep data for today
- `get_today_readiness_data()`: Get readiness data for today
- `get_today_resilience_data()`: Get resilience data for today

## Usage

You'll need an Oura API token to use this server. You can obtain one by:

1. Going to the [Oura Developer Portal](https://cloud.ouraring.com/v2/docs)
2. Creating a Personal Access Token

### Claude for Desktop

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

```json
{
  "mcpServers": {
    "oura": {
      "command": "uvx",
      "args": ["oura-mcp-server"],
      "env": {
        "OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
      }
    }
  }
}
```

## Example Queries

Once connected, you can ask Claude questions like:

- "What's my sleep score for today?"
- "Show me my readiness data for the past week"
- "How was my sleep from January 1st to January 7th?"
- "What's my resilience score today?"

## Error Handling

The server provides human-readable error messages for common issues:

- Invalid date formats
- API authentication errors
- Network connectivity problems

## License

This project is licensed under the MIT License - see the LICENSE file for details.

---

## Maintainer

  
    Maintainers oversee the project's maintenance, decision-making, and long-term development.
  
  
  
    
  
  
    
  
  

## Core Contributors

  
    The core contributors are the cornerstone of the project.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [YuzeHao2023](https://github.com/YuzeHao2023)
- **Source:** [YuzeHao2023/MCP-oura](https://github.com/YuzeHao2023/MCP-oura)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-yuzehao2023-mcp-oura
- Seller: https://agentstack.voostack.com/s/yuzehao2023
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.