HomeOther › oura-mcp

oura-mcp

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

PythonTypeScript CloudLocal macOSWindowsLinux
★ 0 stars Last pushed 2026-09-23 License: MIT

Topics: Health & Wellness

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (pypi 0.3.6)

uvx mcp-oura

Or add to your MCP client config:

{
  "mcpServers": {
    "oura-mcp": {
      "command": "uvx",
      "args": [
        "mcp-oura"
      ],
      "env": {
        "OURA_SANDBOX": "<YOUR_VALUE>",
        "OURA_CLIENT_ID": "<YOUR_VALUE>",
        "OURA_CLIENT_SECRET": "<YOUR_VALUE>",
        "OURA_CREDENTIALS": "<YOUR_VALUE>",
        "OURA_PAT": "<YOUR_VALUE>",
        "OURA_PAT_FILE": "<YOUR_VALUE>"
      }
    }
  }
}
  • 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 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 secret — 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.

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry