Overview
Oura MCP Server is a Model Context Protocol (MCP) server designed for accessing data from the Oura Ring, a smart ring that tracks health metrics.
To use the Oura MCP Server, clone the repository, install the necessary packages, and configure your credentials from the Oura Cloud Console. You can then run tests to access various health data metrics.
- Access to a wide range of Oura Ring data including sleep, activity, and readiness scores. - Integration with Claude Desktop for enhanced functionality. - Support for both personal access tokens and OAuth2 credentials for secure access.
- Retrieving daily sleep summaries for analysis.
- Monitoring daily activity and readiness scores to improve health.
- Integrating Oura data into custom applications for personalized health insights.
Add to your AI client
Use these steps to connect Oura MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"oura-mcp-elizabethtrykin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-oura-mcp-elizabethtrykin"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"oura-mcp-elizabethtrykin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-oura-mcp-elizabethtrykin"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"oura-mcp-elizabethtrykin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-oura-mcp-elizabethtrykin"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"oura-mcp-elizabethtrykin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-oura-mcp-elizabethtrykin"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"oura-mcp-elizabethtrykin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-oura-mcp-elizabethtrykin"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"oura-mcp-elizabethtrykin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-oura-mcp-elizabethtrykin"
]
}
}
}FAQ
What prerequisites are needed to run the Oura MCP Server?
You need Node.js (v16+) and an Oura account to get started.
How do I obtain credentials for the Oura MCP Server?
You can obtain either a Personal Access Token for testing or OAuth2 credentials for production use from the Oura Cloud Console.
Can I integrate Oura MCP Server with other applications?
Yes! The server can be integrated with applications like Claude Desktop for enhanced functionality.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3056,"uuid":"6d01d78d-9f3a-450b-92f2-bc43d579427b","name":"oura-mcp","title":"Oura MCP Server","description":"An MCP server for oura","avatar_url":"https://avatars.githubusercontent.com/u/72474571?v=4","created_at":"2025-03-17T02:42:49.494Z","updated_at":"2025-03-17T03:21:02.950Z","status":"created","author_name":"elizabethtrykin","author_avatar_url":"https://avatars.githubusercontent.com/u/72474571?v=4","tags":"[]","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/elizabethtrykin/oura-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-16 12:18:31\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]