Oura-mcp Server

The Oura v2 API as an MCP server. Paginates, fixes the date range, warns when data is missing.

Local serverstdio

What is the Oura-mcp Server?

Oura-mcp is an MCP integration. The Oura v2 API as an MCP server. Paginates, fixes the date range, warns when data is missing.

Packages and local setup

The published pypi package is mcp-oura, version 0.4.0. Its declared MCP transport is stdio.

The package declares OURA_SANDBOX: Set to 1 to use Oura's official synthetic data with no credentials. The recommended way to try the server before authenticating.; OURA_CLIENT_ID: client_id of your Oura application, for OAuth2. Register one at https://cloud.ouraring.com/oauth/applications with the redirect http://localhost:9876/callback/ (the trailing slash is required).; OURA_CLIENT_SECRET: client_secret of your Oura application. Only needed when running oura-mcp --authorize and when refreshing the token.; OURA_CREDENTIALS: Where the OAuth2 credentials file lives. Defaults to ~/.config/oura-mcp/credentials.json, mode 600.; OURA_PAT: Oura Personal Access Token. Only if you already had one: Oura stopped issuing them in December 2025.; OURA_PAT_FILE: Path to a file holding the personal token. Preferable to OURA_PAT: an MCP server is registered in a JSON that gets backed up and shared when asking for help; a separate file rotates without touching the config..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.4.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
OURA_SANDBOXSet to 1 to use Oura's official synthetic data with no credentials. The recommended way to try the server before authenticating.Optional
OURA_CLIENT_IDclient_id of your Oura application, for OAuth2. Register one at https://cloud.ouraring.com/oauth/applications with the redirect http://localhost:9876/callback/ (the trailing slash is required).Optional
OURA_CLIENT_SECRETclient_secret of your Oura application. Only needed when running oura-mcp --authorize and when refreshing the token.Optional
OURA_CREDENTIALSWhere the OAuth2 credentials file lives. Defaults to ~/.config/oura-mcp/credentials.json, mode 600.Optional
OURA_PATOura Personal Access Token. Only if you already had one: Oura stopped issuing them in December 2025.Optional
OURA_PAT_FILEPath to a file holding the personal token. Preferable to OURA_PAT: an MCP server is registered in a JSON that gets backed up and shared when asking for help; a separate file rotates without touching the config.Optional