Overview
What is Oura MCP Server?
Oura MCP Server is a Model Context Protocol (MCP) server that provides access to Oura Ring data. It enables developers to retrieve health metrics—such as sleep, activity, readiness, and stress—via MCP clients like Claude Desktop.
How to use Oura MCP Server?
Install Node.js v16+, clone the repository, run npm install and npm run build. Configure credentials in a .env file using a Personal Access Token (for testing) or OAuth2 credentials (for production). Test with node test.js <tool_name> <date> (e.g., node test.js get_daily_sleep 2023-05-01). For Claude Desktop, add the server to its MCP config with the oura key, specifying the build path and environment variable for the access token.
Key features of Oura MCP Server
- Accesses 15+ Oura Ring data resources (e.g., daily_sleep, daily_activity)
- Supports Personal Access Token and OAuth2 authentication
- Integrates directly with Claude Desktop via MCP
- Provides date‑filtered tools (e.g.,
get_daily_sleep) - Returns structured JSON for each resource
Use cases of Oura MCP Server
- Retrieve daily sleep summaries and detailed sleep data
- Fetch daily activity, readiness, and resilience scores
- Access workout and session data for fitness analysis
- Integrate Oura health metrics into AI‑powered applications
FAQ from Oura MCP Server
What prerequisites are needed?
Node.js v16+ and a valid Oura account. Credentials come from the Oura Cloud Console.
How do I authenticate with Oura MCP Server?
You can use a Personal Access Token (quick start) or OAuth2 client ID/secret (production). Set the appropriate environment variables in a .env file.
How do I integrate Oura MCP Server with Claude Desktop?
Add an oura entry to Claude Desktop’s MCP config file. Specify the command (node), the absolute path to build/index.js, and the access token as an environment variable.
What data does Oura MCP Server expose?
It exposes 15 resources including personal info, daily activity, sleep, readiness, workouts, sessions, SpO2, stress, resilience, cardiovascular age, and VO2 max.
How can I test a tool?
Run node test.js <tool_name> <date> from the project root, replacing <tool_name> with a tool like get_daily_sleep and <date> with a YYYY-MM-DD date.
