INDIVIDUAL MCP TOOL

oura_list_documents

List documents from one Oura collection over a date range.

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://oura.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for oura_list_documents and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.oura-mcp]
url = "https://oura.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "oura-mcp": {
      "type": "http",
      "url": "https://oura.usefulapi.io/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: oura-mcp
Remote MCP URL: https://oura.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "oura-mcp": {
      "url": "https://oura.usefulapi.io/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "oura-mcp": {
      "type": "http",
      "url": "https://oura.usefulapi.io/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "oura-mcp",
  "transport": "streamable-http",
  "url": "https://oura.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

oura_get_personal_info — Fetch the wearer's profile — age, weight, height, biological sex and email.
oura_get_document — Fetch a single document by id from one collection.
oura_get_heartrate — Fetch individual heart-rate samples over a DATETIME range.
oura_get_ring_battery_level — Fetch ring battery readings over a DATETIME range, or just the latest.
oura_list_webhook_subscriptions — List the webhook subscriptions registered for the application.
oura_get_webhook_subscription — Fetch a single webhook subscription with its callback URL, event type and expiry.
oura_create_webhook_subscription — Register a webhook so Oura notifies your callback URL when data changes.
oura_renew_webhook_subscription — Extend a webhook subscription's expiry.