oura-mcp
An MCP server for Oura Ring that exposes your health and wellness data as tools for AI assistants.
Setup
- Create a personal access token at cloud.ouraring.com
- 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 --httpStarts on http://localhost:3000/mcp by default. Custom endpoint:
npx -y oura-mcp --http /custom/pathPort 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 checkLicense
MIT.
