Skip to content

Oura MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi

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

Deletes · 3

10 tools: 3 can delete or cancel things and 7 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

10 tools

Deletes or cancels 3Claude Code: deny
  • oura_create_webhook_subscriptionRegister a webhook so Oura notifies your callback URL when data changes.No findings

    Why it is in this group

    • The name "oura_create_webhook_subscription" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Create a webhook subscription
    • destructiveHint: true
  • oura_delete_webhook_subscriptionRemove a webhook subscription.No findings

    Why it is in this group

    • The name "oura_delete_webhook_subscription" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Remove a webhook subscription. Notifications stop immediately. Oura: DELETE /v2/webhook/subscription/{id}.

    Annotations the server declares

    • title: Delete a webhook subscription
    • destructiveHint: true
  • oura_renew_webhook_subscriptionExtend a webhook subscription's expiry.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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}.

    Annotations the server declares

    • title: Renew a webhook subscription
    • destructiveHint: true
Only reads 7Claude Code: allow
  • oura_get_documentFetch a single document by id from one collection.No findings

    Why it is in this group

    • The name "oura_get_document" says "get": a word for reading.
    Description, as the server wrote it
    Fetch a single document by id from one collection. Ids come from oura_list_documents. Oura: GET /v2/usercollection/{collection}/{document_id}.

    Annotations the server declares

    • title: Get one document
    • readOnlyHint: true
  • oura_get_heartrateFetch individual heart-rate samples over a DATETIME range.No findings

    Why it is in this group

    • The name "oura_get_heartrate" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get heart-rate samples
    • readOnlyHint: true
  • oura_get_personal_infoFetch the wearer's profile — age, weight, height, biological sex and email.No findings

    Why it is in this group

    • The name "oura_get_personal_info" says "get": a word for reading.
    Description, as the server wrote it
    Fetch the wearer's profile — age, weight, height, biological sex and email. Oura: GET /v2/usercollection/personal_info.

    Annotations the server declares

    • title: Get personal info
    • readOnlyHint: true
  • oura_get_ring_battery_levelFetch ring battery readings over a DATETIME range, or just the latest.No findings

    Why it is in this group

    • The name "oura_get_ring_battery_level" says "get": a word for reading.
    Description, as the server wrote it
    Fetch ring battery readings over a DATETIME range, or just the latest. Oura: GET /v2/usercollection/ring_battery_level.

    Annotations the server declares

    • title: Get ring battery level
    • readOnlyHint: true
  • oura_get_webhook_subscriptionFetch a single webhook subscription with its callback URL, event type and expiry.No findings

    Why it is in this group

    • The name "oura_get_webhook_subscription" says "get": a word for reading.
    Description, as the server wrote it
    Fetch a single webhook subscription with its callback URL, event type and expiry. Oura: GET /v2/webhook/subscription/{id}.

    Annotations the server declares

    • title: Get one webhook subscription
    • readOnlyHint: true
  • oura_list_documentsList documents from one Oura collection over a date range.No findings

    Why it is in this group

    • The name "oura_list_documents" says "list": a word for reading.
    Description, as the server wrote it
    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 wearer's own annotations, rest_mode_period and ring_configuration for device state. Oura: GET /v2/usercollection/{collection}.

    Annotations the server declares

    • title: List documents from a collection
    • readOnlyHint: true
  • oura_list_webhook_subscriptionsList the webhook subscriptions registered for the application.No findings

    Why it is in this group

    • The name "oura_list_webhook_subscriptions" says "list": a word for reading.
    Description, as the server wrote it
    List the webhook subscriptions registered for the application. Oura: GET /v2/webhook/subscription.

    Annotations the server declares

    • title: List webhook subscriptions
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.16.3. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__oura__oura_get_personal_info",
      "mcp__oura__oura_list_documents",
      "mcp__oura__oura_get_document",
      "mcp__oura__oura_get_heartrate",
      "mcp__oura__oura_get_ring_battery_level",
      "mcp__oura__oura_list_webhook_subscriptions",
      "mcp__oura__oura_get_webhook_subscription"
    ],
    "ask": [],
    "deny": [
      "mcp__oura__oura_create_webhook_subscription",
      "mcp__oura__oura_renew_webhook_subscription",
      "mcp__oura__oura_delete_webhook_subscription"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as oura. Review it before you use it.