MCP server
Oura MCP by usefulapi
Read sleep, readiness, activity, stress, heart rate and workouts from the Oura Ring.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://oura.usefulapi.io/mcpInstall 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