Server data from the Official MCP Registry
MCP server for Oura Ring API v2 (sleep, activity, readiness, heart rate, workouts).
MCP server for Oura Ring API v2 (sleep, activity, readiness, heart rate, workouts).
Valid MCP server (2 strong, 2 medium validity signals). 4 code issues detected. No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: 3 highly-trusted packages. 4 finding(s) downgraded by scanner intelligence.
13 files analyzed · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: OURA_CLIENT_ID
Environment variable: OURA_CLIENT_SECRET
Environment variable: OURA_CALLBACK_PORT
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-yasuakiomokawa-oura-mcp": {
"env": {
"OURA_CLIENT_ID": "your-oura-client-id-here",
"OURA_CALLBACK_PORT": "your-oura-callback-port-here",
"OURA_CLIENT_SECRET": "your-oura-client-secret-here"
},
"args": [
"-y",
"@yasuakiomokawa/oura-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
A Model Context Protocol server for the Oura Ring API v2. Exposes sleep, activity, readiness, heart rate, and workout data to MCP-compatible clients (Claude Desktop, Claude Code, Cursor, ...) via OAuth.
npx @yasuakiomokawa/oura-mcp configure
The wizard collects your Oura Client ID/Secret, walks through browser OAuth, saves tokens to ~/.config/oura-mcp/, and adds an mcpServers.oura entry to any detected MCP client config. Restart the client and the tools below are available.
Re-running configure pre-fills the saved Client ID / port so you only need to press Enter to keep them. Type --force to wipe saved state and start from scratch:
npx @yasuakiomokawa/oura-mcp configure --force
http://localhost:54321/callback
(or http://localhost:<port>/callback if you customize OURA_CALLBACK_PORT)npx @yasuakiomokawa/oura-mcp configureThree paths depending on your client:
1. MCP Registry (auto-discovery clients)
Once published to the official MCP Registry, supported clients can install io.github.YasuakiOmokawa/oura-mcp from their UI. The wizard step still has to run once to obtain OAuth tokens.
2. Manual config (Claude Desktop / Claude Code / Cursor)
Run npx @yasuakiomokawa/oura-mcp configure — Step 4 of the wizard auto-detects:
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)~/.claude.json./.mcp.json~/.cursor/mcp.json./.cursor/mcp.jsonEach detected file is backed up to <file>.bak.<ISO-timestamp> before an atomic write.
To configure manually, add to your client config:
{
"mcpServers": {
"oura": {
"command": "npx",
"args": ["-y", "@yasuakiomokawa/oura-mcp"]
}
}
}
3. Skill (optional)
The companion oura-api-skill ships per-endpoint reference and three workflow recipes (weekly review / sleep trend / recovery check). Bundle it as a Claude Code plugin or import into your skills directory.
| Tool | Purpose |
|---|---|
oura_authenticate | Start OAuth flow in browser; returns the URL. Used after refresh_token expires. |
oura_auth_status | Check current token validity and expiry. |
oura_clear_auth | Wipe stored tokens. |
oura_api_list_paths | List every supported GET endpoint with summaries. |
oura_api_get | Generic GET to /v2/.... Auto-paginates via max_pages (1-20) or accepts next_token in params. |
oura_api_get returns structuredContent with { status, data, next_token, pages_fetched, has_more }.
Two ways, env vars take precedence over the config file:
# Option A — env vars (set both together)
OURA_CLIENT_ID=...
OURA_CLIENT_SECRET=...
OURA_CALLBACK_PORT=54321 # optional
# Option B — config file (managed by the wizard)
~/.config/oura-mcp/config.json # 0600
~/.config/oura-mcp/tokens.json # 0600
config.json schema:
{
"schemaVersion": 1,
"clientId": "...",
"clientSecret": "...",
"callbackPort": 54321
}
oura_authenticate (in chat) or npx @yasuakiomokawa/oura-mcp configure (in terminal).OURA_CALLBACK_PORT=<other port> and update the redirect URI in your Oura developer app to match.oura_api_list_paths. Common slips: missing /v2/ prefix, typo in daily_sleep.OURA_LOG_LEVEL=debug for verbose stderr logging.state validation on the OAuth flow.~/.config/oura-mcp/tokens.json with 0600 permissions, written atomically.access_token, refresh_token, client_secret, code, code_verifier) are redacted from logs via utils/redact.ts.User-Agent: oura-mcp/<version>, all requests use AbortSignal.timeout (30 s API / 10 s OAuth).127.0.0.1:54321 only; redirect URI uses the loopback name localhost for Oura compatibility.git clone https://github.com/YasuakiOmokawa/oura-mcp.git
cd oura-mcp
npm install
npm test
npm run build
Useful scripts:
npm run lint / npm run typecheck — Biome + TypeScript checksnpm run test:coverage — Vitest with V8 coveragenpm run update:docs — re-fetch the Oura OpenAPI schema and regenerate skills/oura-api-skill/references/Oura Ring の API v2 を MCP 経由で扱うためのサーバーです。npx @yasuakiomokawa/oura-mcp configure 一発で OAuth 認可からクライアント設定追記まで完了します。Claude Desktop / Claude Code / Cursor を自動検出するので、対応クライアントを使っていれば手動編集は不要です。トークンは ~/.config/oura-mcp/ に 0600 で保存され、refresh_token 失効時はチャットから oura_authenticate を呼べば再認可できます。詳しくは上記 Troubleshooting を参照してください。
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.