Oura Ring MCP Server
by antvslio.github.AntVsl/oura-mcpv0.4.2
Sleep, readiness, HRV, resting heart rate, activity and stress from your Oura Ring
context tax
queued
security
queued
cold start
queued
freshness
Maintained41d ago
Install Oura Ring MCP server
Install in Claude Code
claude mcp add my-oura -e OURA_CLIENT_SECRET='<oura-client-secret>' -- uvx my-oura-mcpInstall in Cursor
{
"mcpServers": {
"my-oura": {
"command": "uvx",
"args": [
"my-oura-mcp"
],
"env": {
"OURA_CLIENT_SECRET": "<oura-client-secret>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"my-oura": {
"command": "uvx",
"args": [
"my-oura-mcp"
],
"env": {
"OURA_CLIENT_SECRET": "<oura-client-secret>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"my-oura": {
"type": "stdio",
"command": "uvx",
"args": [
"my-oura-mcp"
],
"env": {
"OURA_CLIENT_SECRET": "<oura-client-secret>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"my-oura": {
"command": "uvx",
"args": [
"my-oura-mcp"
],
"env": {
"OURA_CLIENT_SECRET": "<oura-client-secret>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| OURA_MCP_TOKEN | yes | yes | Shared secret guarding the HTTP endpoint. Required whenever the server binds to anything other than loopback; without it the server refuses to start |
| OURA_PUBLIC_URL | — | — | Public https address, without a trailing slash. Enables OAuth 2.1 for Claude.ai and ChatGPT; leave empty for local or Bearer-token clients |
| OURA_OAUTH_ALLOWED_REDIRECT_ORIGINS | — | — | Comma-separated trusted OAuth redirect origins; defaults to Claude.ai and ChatGPT |
| OURA_CLIENT_ID | — | — | Client ID of your Oura application from developer.ouraring.com |
| OURA_CLIENT_SECRET | — | yes | Client secret of your Oura application |
| OURA_TZ | — | — | IANA timezone deciding what counts as today. Container clocks run in UTC, so set this |
| OURA_REDIRECT_URI | — | — | OAuth redirect URI; must match the Oura application byte for byte |
| OURA_API_MODE | — | — | sandbox for Oura's synthetic data (no auth needed), production for your own |
| OURA_TOKEN_STORE | — | — | Where the OAuth flow stores tokens. Written by the server, not set by hand |
Freshness
Maintained — last maintenance signal 41d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-30 · 41d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-30 · 41d ago · official registry · v0.4.2
FAQ
›How do I install the Oura Ring MCP server in Claude Code?
Run: claude mcp add my-oura -e OURA_CLIENT_SECRET='<oura-client-secret>' -- uvx my-oura-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Oura Ring require an API key?
Yes. It expects OURA_MCP_TOKEN, OURA_CLIENT_SECRET, of which 2 are secrets.
›Can I use Oura Ring as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Oura Ring in the official MCP registry?
Yes, as io.github.AntVsl/oura-mcp.