oura-mcp

@louis030195/oura-mcp

Dead simple MCP (Model Context Protocol) server for Oura Ring. Get your sleep, readiness, and activity data directly from Claude, ChatGPT, or any LLM that supports MCP.

---

<div align="center">

💖 Support This Project

If you find this MCP server useful, please consider supporting its development!


👉 Click here to support this project

Your support helps maintain and improve this tool. Thank you! 🙏

</div>

---

Features

• 😴 Sleep data (score, REM, deep, light sleep stages)
• ⚡ Readiness score (HRV, resting HR, body temperature)
• 🏃 Activity data (steps, calories, activity score)
• ❤️ Heart rate monitoring

Installation

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["-y", "@louis030195/oura-mcp"],
      "env": {
        "OURA_API_KEY": "your-oura-api-key"
      }
    }
  }
}

Claude Code

# Install globally in user scope with API key
claude mcp add -s user oura npx -e OURA_API_KEY=your-oura-api-key -- -y @louis030195/oura-mcp

Get Your Oura API Key

1. Go to Oura Personal Access Tokens
2. Click "Create New Personal Access Token"
3. Copy your token (starts with something like 4SKHEL...)

Usage

Once configured, you can use natural language to access your Oura data:

• "How did I sleep last night?"
• "Show me my sleep data for the past week"
• "What's my readiness score today?"
• "How many steps did I take yesterday?"
• "Show my heart rate data from last week"

Tools

oura_sleep

Get daily sleep data including sleep score, sleep stages (REM, deep, light), efficiency, and timing.

Parameters:

• start_date (required): Start date in YYYY-MM-DD format
• end_date (optional): End date in YYYY-MM-DD format

oura_readiness

Get daily readiness score, HRV balance, resting heart rate, and body temperature deviation.

Parameters:

• start_date (required): Start date in YYYY-MM-DD format
• end_date (optional): End date in YYYY-MM-DD format

oura_activity

Get daily activity data including steps, calories burned, and activity score.

Parameters:

• start_date (required): Start date in YYYY-MM-DD format
• end_date (optional): End date in YYYY-MM-DD format

oura_heartrate

Get heart rate data over time.

Parameters:

• start_date (required): Start date in YYYY-MM-DD format
• end_date (optional): End date in YYYY-MM-DD format

Development

# Clone the repo
git clone https://github.com/louis030195/oura-mcp.git
cd oura-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
OURA_API_KEY=your-api-key npm start

License

MIT

Author

Louis Beaumont