Skip to content
MCP server

Oura MCP by usefulapi

Read sleep, readiness, activity, stress, heart rate and workouts from the Oura Ring.

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Oura MCP by usefulapi

Oura MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http oura https://oura.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://oura.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "oura": {
      "url": "https://oura.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (10)

Read directly from the server.

oura_get_personal_info
Fetch the wearer's profile — age, weight, height, biological sex and email. Oura: GET /v2/usercollection/personal_info.
oura_list_documents
List documents from one Oura collection over a date range. This is the main read: pick `collection` for what you want — daily_sleep and sleep for sleep, daily_readiness for recovery, daily_activity for movement, daily_stress and daily_resilience for load, workout and session for exercise, daily_spo2, daily_cardiovascular_age and vO2_max for cardiovascular measures, tag and enhanced_tag for the wea
oura_get_document
Fetch a single document by id from one collection. Ids come from oura_list_documents. Oura: GET /v2/usercollection/{collection}/{document_id}.
oura_get_heartrate
Fetch individual heart-rate samples over a DATETIME range. This collection is sampled continuously, so it uses start_datetime/end_datetime rather than dates, and can return a great many points — narrow the window or pass latest. Oura: GET /v2/usercollection/heartrate.
oura_get_ring_battery_level
Fetch ring battery readings over a DATETIME range, or just the latest. Oura: GET /v2/usercollection/ring_battery_level.
oura_list_webhook_subscriptions
List the webhook subscriptions registered for the application. Oura: GET /v2/webhook/subscription.
oura_get_webhook_subscription
Fetch a single webhook subscription with its callback URL, event type and expiry. Oura: GET /v2/webhook/subscription/{id}.
oura_create_webhook_subscription
Register a webhook so Oura notifies your callback URL when data changes. Oura verifies the URL before activating it, and the subscription EXPIRES — renew it with oura_renew_webhook_subscription. Oura: POST /v2/webhook/subscription.
oura_renew_webhook_subscription
Extend a webhook subscription's expiry. Oura subscriptions lapse if not renewed, so this is the tool that keeps a live integration alive. Oura: PUT /v2/webhook/subscription/renew/{id}.
oura_delete_webhook_subscription
Remove a webhook subscription. Notifications stop immediately. Oura: DELETE /v2/webhook/subscription/{id}.

Oura MCP by usefulapi FAQ

How do I add Oura MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http oura https://oura.usefulapi.io/mcp