Skip to main content
MCP server CX Codex

ouramcp — Claude Code MCP server: features and setup

ouramcp is an MCP server for Claude Code that connects an agent to Oura readiness, sleep, activity, and HRV data. It uses OAuth to access an Oura account.

MIT ★ 6 updated 2026-11-05

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env OURA_CLIENT_ID=<OURA_CLIENT_ID> --env OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> --env OURA_REDIRECT_URI=<OURA_REDIRECT_URI> --env OURA_TOKEN_PATH=<OURA_TOKEN_PATH> --env OURA_PRIVACY_MODE=<OURA_PRIVACY_MODE> --transport stdio ouramcp -- npx -y oura-mcp-unofficial
Open on GitHub

What ouramcp does

ouramcp gives an agent access to Oura Ring metrics, including readiness, sleep, daily activity, and HRV. It handles OAuth on the local machine and reshapes responses from separate API endpoints. Tokens stay on that machine; raw responses are opt-in through privacy settings.

Setup requires an Oura app with a client id, a client secret, and the redirect URI http://127.0.0.1:3000/callback. Authorization runs through a browser. The server starts with npx; stdio is the default transport, while its optional HTTP mode listens on loopback only.

What it helps with

  • send Oura readiness scores to an agent
  • review sleep and activity metrics together
  • access HRV data through MCP

Example prompts for the agent

  • Show my latest Oura readiness and sleep metrics.
  • Compare my recent activity and HRV data.
  • Summarize what my Oura sleep data shows.

How to install ouramcp

Platform CLI

claude mcp add --env OURA_CLIENT_ID=<OURA_CLIENT_ID> --env OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> --env OURA_REDIRECT_URI=<OURA_REDIRECT_URI> --env OURA_TOKEN_PATH=<OURA_TOKEN_PATH> --env OURA_PRIVACY_MODE=<OURA_PRIVACY_MODE> --transport stdio ouramcp -- npx -y oura-mcp-unofficial

Replace <…> with your own values. 3 more environment variables are in the server README

Step 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 ouramcp

How do I install ouramcp in Claude Code?

Add the server with claude mcp add ouramcp -e OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> -- npx -y oura-mcp-unofficial. OAuth also requires an Oura app and its credentials.

What does ouramcp do?

It connects an agent to Oura readiness, sleep, activity, and HRV data. OAuth runs locally, and tokens remain on the machine.

What does ouramcp need to run?

It requires an Oura app, a client id, a client secret, and the redirect URI http://127.0.0.1:3000/callback, followed by OAuth authorization.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open