oura-ring-mcp-server
CommunityMCP server by jordanburke · updated · ★ 1 · 120 downloads a week
Oura Ring MCP server for the Oura API v2: sleep, readiness, activity, heart rate, and more. oura-ring-mcp-server is a community project by jordanburke, not verified by a company domain.
Last commit 4 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
OURA_CLIENT_IDEnvironment variable | Required | Oura OAuth2 client ID (register an app at https://cloud.ouraring.com/oauth/applications, then run `oura-ring-mcp-server login` once to authorize) |
OURA_CLIENT_SECRETEnvironment variable, secret | Required | Oura OAuth2 client secret from the same application |
OURA_SANDBOXEnvironment variable | Optional | Use Oura's /sandbox/ demo data instead of real data (true/false, default false) |
TRANSPORT_TYPEEnvironment variable | Optional | Transport: 'stdio' (default) or 'httpStream' for remote/Docker deployments |
PORTEnvironment variable | Optional | HTTP port for httpStream transport (default 3000) |
HOSTEnvironment variable | Optional | HTTP host for httpStream transport (default 0.0.0.0) |
OURA_TELEMETRY_FILEEnvironment variable | Optional | Write NDJSON telemetry events to this file path (safe under any transport) |
OURA_TELEMETRY_CONSOLEEnvironment variable | Optional | Console telemetry under httpStream transport: true (default) or false |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install oura-ring-mcp-server
Built from the published package, never by AIclaude mcp add oura-ring-mcp-server -e OURA_CLIENT_ID=YOUR_OURA_CLIENT_ID -e OURA_CLIENT_SECRET=YOUR_OURA_CLIENT_SECRET -- npx -y oura-ring-mcp-serverRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"oura-ring-mcp-server": {
"command": "npx",
"args": [
"-y",
"oura-ring-mcp-server"
],
"env": {
"OURA_CLIENT_ID": "YOUR_OURA_CLIENT_ID",
"OURA_CLIENT_SECRET": "YOUR_OURA_CLIENT_SECRET"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
Step-by-step: install oura-ring-mcp-server in Claude Desktop
{
"mcpServers": {
"oura-ring-mcp-server": {
"command": "npx",
"args": [
"-y",
"oura-ring-mcp-server"
],
"env": {
"OURA_CLIENT_ID": "YOUR_OURA_CLIENT_ID",
"OURA_CLIENT_SECRET": "YOUR_OURA_CLIENT_SECRET"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"oura-ring-mcp-server": {
"command": "npx",
"args": [
"-y",
"oura-ring-mcp-server"
],
"env": {
"OURA_CLIENT_ID": "YOUR_OURA_CLIENT_ID",
"OURA_CLIENT_SECRET": "YOUR_OURA_CLIENT_SECRET"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add oura-ring-mcp-server --env OURA_CLIENT_ID=YOUR_OURA_CLIENT_ID --env OURA_CLIENT_SECRET=YOUR_OURA_CLIENT_SECRET -- npx -y oura-ring-mcp-server{
"mcpServers": {
"oura-ring-mcp-server": {
"command": "npx",
"args": [
"-y",
"oura-ring-mcp-server"
],
"env": {
"OURA_CLIENT_ID": "YOUR_OURA_CLIENT_ID",
"OURA_CLIENT_SECRET": "YOUR_OURA_CLIENT_SECRET"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
Step-by-step: install oura-ring-mcp-server in Antigravity CLI
gemini mcp add oura-ring-mcp-server npx -y oura-ring-mcp-serverGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the oura-ring-mcp-server block.
Alternatives to oura-ring-mcp-server
All alternatives →Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
Validate oh-my-posh configurations and segment snippets against the official schema.
Real-time global intelligence across conflict, markets, energy, trade, shipping and cyber. 95 tools.
Securely access and manage FHIR healthcare data stored in Medplum.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
MCP tools for interacting with Microsoft Fabric
oura-ring-mcp-server: common questions
How do I install oura-ring-mcp-server?
In Claude Code run claude mcp add oura-ring-mcp-server -e OURA_CLIENT_ID=YOUR_OURA_CLIENT_ID -e OURA_CLIENT_SECRET=YOUR_OURA_CLIENT_SECRET -- npx -y oura-ring-mcp-server. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is oura-ring-mcp-server the official server?
oura-ring-mcp-server is a community project by jordanburke, not verified by a company domain.
Is oura-ring-mcp-server free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is oura-ring-mcp-server safe to use?
It scores 75 of 100. Grades: maintenance A, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to oura-ring-mcp-server?
Similar MCP servers: Jitsu, Oh My Posh Validator, World Monitor, mcp.
Does oura-ring-mcp-server work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
