Privacy-first, unofficial Oura MCP server for AI health, sleep, activity and heart-rate agents.
Connect Runs on your machine
claude mcp add ouramcp -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> -e OURA_CACHE=<OURA_CACHE> -e OURA_CACHE_PATH=<OURA_CACHE_PATH> -e OURA_NO_CACHE=<OURA_NO_CACHE> -- npx -y [email protected]{
"mcpServers": {
"ouramcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"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>",
"OURA_CACHE": "<OURA_CACHE>",
"OURA_CACHE_PATH": "<OURA_CACHE_PATH>",
"OURA_NO_CACHE": "<OURA_NO_CACHE>"
}
}
}
}{
"mcpServers": {
"ouramcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"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>",
"OURA_CACHE": "<OURA_CACHE>",
"OURA_CACHE_PATH": "<OURA_CACHE_PATH>",
"OURA_NO_CACHE": "<OURA_NO_CACHE>"
}
}
}
}{
"servers": {
"ouramcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"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>",
"OURA_CACHE": "<OURA_CACHE>",
"OURA_CACHE_PATH": "<OURA_CACHE_PATH>",
"OURA_NO_CACHE": "<OURA_NO_CACHE>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
OURA_CLIENT_IDOptional | Oura OAuth client ID. Optional when configured with oura-mcp-server setup. |
OURA_CLIENT_SECRETOptional, secret | Oura OAuth client secret. Prefer oura-mcp-server setup so this secret is stored in ~/.oura-mcp/config.json instead of MCP client config. |
OURA_REDIRECT_URIOptional | Redirect URI configured in the Oura Developer Dashboard. Optional when configured with oura-mcp-server setup. |
OURA_TOKEN_PATHOptional | Optional local path for OAuth tokens. Defaults to ~/.oura-mcp/tokens.json. |
OURA_PRIVACY_MODEOptional | Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full Oura API payloads, not continuous 24/7 raw sensor telemetry. |
OURA_CACHEOptional | Optional SQLite cache toggle. Set to true or sqlite to enable. |
OURA_CACHE_PATHOptional | Optional local SQLite cache path. Defaults to ~/.oura-mcp/cache.sqlite. |
OURA_NO_CACHEOptional | Set to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 29 May 2026 |
| Last updated | 29 May 2026 |
| Registry name | io.github.davidmosiah/ouramcp |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.