MCP for Oura — Claude Code MCP server: what it does, how to install
MCP for Oura brings Oura Ring data into an AI assistant through 21 read-only tools. Each user signs into their own Oura account with OAuth.
MIT updated 2026-10-04
claude mcp add --transport http mcp-oura https://mcp-oura.smirnov.link/mcpWhat MCP for Oura does
The server exposes sleep, readiness, activity and biometric data from Oura Ring as separate tools: a daily snapshot, a date range up to 180 days, a breakdown of the latest night, workouts, mindfulness sessions, minute-level heart rate, stress levels, SpO2, VO2 max, and recommended bedtime. A separate set of tools checks a day's metrics against a personal 30- and 90-day baseline and flags statistically unusual days.
It runs as a hosted connector on Cloudflare Workers with a two-stage OAuth setup: the client first authorizes against this server, which then separately authorizes against Oura and keeps the resulting token encrypted. Right now only ten authorized users can connect at once, a limit set by Oura's development-mode application tier until a production application gets approved.
Menstrual cycle tools were dropped from the build, since Oura's public v2 API has no endpoints for that data — it only exists inside the Oura app itself. Manually tagged entries, pulled through the tag-reading tool, can partly stand in for it.
What it helps with
- pull a stage-by-stage breakdown of last night's sleep
- check today's HRV against a personal baseline
- get a morning readiness and recommended-sleep briefing
- see whether a logged tag like alcohol affects recovery
- flag days in a month with unusual metrics
Example prompts for the agent
- How did I sleep last night?
- Compare my HRV to my 30-day baseline
- Give me a morning briefing with readiness and recommended sleep time
How to install MCP for Oura
Platform CLI: remote server
claude mcp add --transport http mcp-oura https://mcp-oura.smirnov.link/mcpPlatform CLI: remote server
codex mcp add mcp-for-oura --url https://mcp-oura.smirnov.link/mcpConfig file
{
"mcpServers": {
"mcp-for-oura": {
"url": "https://mcp-oura.smirnov.link/mcp"
}
}
}Config file
{
"servers": {
"mcp-for-oura": {
"type": "http",
"url": "https://mcp-oura.smirnov.link/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http mcp-for-oura https://mcp-oura.smirnov.link/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MCP for Oura
How do I install MCP for Oura in Claude Code?
Run claude mcp add --transport http mcp-oura https://mcp-oura.smirnov.link/mcp or claude mcp add --transport http mcp-for-oura https://mcp-oura.smirnov.link/mcp.
What does MCP for Oura do?
It gives an AI assistant read-only access to Oura Ring data through 21 tools covering sleep, readiness, activity, biometrics and personal trend analytics. Each user connects their own Oura account through OAuth.
Why doesn't MCP for Oura have cycle-tracking tools?
They were removed because Oura's public v2 API doesn't expose menstrual cycle data, which lives only inside the Oura app. Manually logged tags can serve as a partial substitute.