A
licenseB
qualityA
maintenanceLocal-first MCP server that connects AI agents to your Oura Ring readiness, sleep, activity, and HRV data. Tokens never leave your machine.
27
88 npm
2
MIT
oura-mcp
by johnie
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@oura-mcpshow my sleep data from last night"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: oura-mcp-server
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 |
| User profile: age, weight, height, biological sex, email |
| Activity score, steps, calories, active minutes |
| Estimated vascular age |
| Sleep score, contributors (deep, REM, efficiency, etc.) |
| Blood oxygen saturation averages |
| Stress/recovery minutes and day summary |
| 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.
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues
Related MCP Connectors
Multi-tenant hosted MCP server for Oura Ring — 21 read-only tools, OAuth per user.
MCP server for Withings health data — sleep, activity, heart, and body metrics.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
- ZapierOAuthcom.zapier
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to query Oura Ring health data (sleep, readiness, activity, heart rate, SpO2, stress) via a remote MCP server.6 npmMIT
- AlicenseAqualityDmaintenanceMCP server that enables AI assistants to access Whoop health data including recovery, sleep, workouts, and daily strain for personalized health recommendations.7458 npmMIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables AI assistants to access Oura Ring health data including sleep, activity, readiness, heart rate, and stress through read-only tools.406 npm1MIT