oura-mcp

An MCP server for Oura Ring that exposes your health and wellness data as tools for AI assistants.

Setup

1. Create a personal access token at cloud.ouraring.com
2. Copy the token

Usage

stdio (default)

Add to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["-y", "oura-mcp"],
      "env": {
        "OURA_ACCESS_TOKEN": "<your-token>"
      }
    }
  }
}

Streamable HTTP

OURA_ACCESS_TOKEN=<your-token> npx -y oura-mcp --http

Starts on http://localhost:3000/mcp by default. Custom endpoint:

npx -y oura-mcp --http /custom/path

Port is configurable via PORT environment variable.

Tools

All tools support response_format (json | markdown) and paginated endpoints accept start_date, end_date, limit, and next_token.

| Tool | Description | |------|-------------| | oura_get_personal_info | User profile: age, weight, height, biological sex, email | | oura_get_daily_activity | Activity score, steps, calories, active minutes | | oura_get_daily_cardiovascular_age | Estimated vascular age | | oura_get_daily_sleep | Sleep score, contributors (deep, REM, efficiency, etc.) | | oura_get_daily_spo2 | Blood oxygen saturation averages | | oura_get_daily_stress | Stress/recovery minutes and day summary | | oura_get_heartrate | Heart rate time-series with BPM summary in markdown mode |

Development

bun install
bun run src/index.ts                    # stdio mode
bun run src/index.ts --http             # HTTP mode
npm run build                           # bundle to dist/
npm run format                          # biome format
npx tsc --noEmit                        # type check

License

MIT.