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
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-unofficialWhat 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-unofficialReplace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
codex mcp add ouramcp --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> -- npx -y oura-mcp-unofficialReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"mcpServers": {
"ouramcp": {
"command": "npx",
"args": [
"-y",
"oura-mcp-unofficial"
],
"env": {
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
"OURA_REDIRECT_URI": "<OURA_REDIRECT_URI>",
"OURA_TOKEN_PATH": "<OURA_TOKEN_PATH>",
"OURA_PRIVACY_MODE": "<OURA_PRIVACY_MODE>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"servers": {
"ouramcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"oura-mcp-unofficial"
],
"env": {
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>",
"OURA_REDIRECT_URI": "<OURA_REDIRECT_URI>",
"OURA_TOKEN_PATH": "<OURA_TOKEN_PATH>",
"OURA_PRIVACY_MODE": "<OURA_PRIVACY_MODE>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
gemini mcp add -e OURA_CLIENT_ID=<OURA_CLIENT_ID> -e OURA_CLIENT_SECRET=<OURA_CLIENT_SECRET> -e OURA_REDIRECT_URI=<OURA_REDIRECT_URI> -e OURA_TOKEN_PATH=<OURA_TOKEN_PATH> -e OURA_PRIVACY_MODE=<OURA_PRIVACY_MODE> ouramcp npx -y oura-mcp-unofficialReplace <…> 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.