Skip to main content
Glama
Egoushka

Oura MCP App

by Egoushka
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Oura MCP App

An MCP App that charts Oura Ring trends from a self-hosted warehouse. The tool returns the daily series and an interactive chart: hosts that implement MCP Apps render the chart inline; hosts that don't still get a useful text summary from the same call.

Rendered today by Claude (web and desktop), ChatGPT, VS Code / Copilot Chat 1.109+, Goose and Postman.

What it does

One tool, oura_trend(metric, days), over the daily table:

sleep_score, readiness_score, activity_score, hrv_avg, rhr_lowest, temp_deviation, spo2_avg, steps.

The chart lets you switch metric and range (7/30/90 days) without another model turn — the app calls the tool directly over the host bridge.

Related MCP server: Oura MCP Server

How it is put together

File

Role

server.ts

registerAppTool with _meta.ui.resourceUri, plus registerAppResource serving the UI

db.ts

Read-only Postgres access. Column names come from a fixed map, never from tool input

main.ts

Streamable HTTP transport, stateless (one server per request)

mcp-app.html + src/

The UI, bundled by Vite into a single inlined HTML file

The host fetches exactly one HTML resource, so vite-plugin-singlefile inlines the script and CSS into it. The app reads the host's theme and style variables, so it matches whichever client renders it.

Run

npm install
npm run build
DATABASE_URL="postgres://user:pass@host:5432/oura" npm start

Serves POST /mcp (Streamable HTTP) on PORT, default 5010, plus /healthz.

Connect it

Point an MCP client at http://<host>:5010/mcp. It has no authentication and serves health data: keep it on a private network. For Claude Desktop, add it as a remote MCP server; the app appears when the tool is called.

Layout note

daily is the schema this reads: one row per day with the score and biometric columns listed above. It is produced by oura-platform, not by this repo.

Contributing

Before committing, enable the hooks: git config core.hooksPath .githooks, then copy .private-terms.example to .private-terms and list what must never appear here.

License

Apache-2.0 — see LICENSE and NOTICE.

Not affiliated with or endorsed by Oura; "Oura" is a trademark of its owner. This is a personal data tool, not a medical device, and nothing it shows is medical advice.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Oura MCP Server

    tomekkorbak
    A
    license
    B
    quality
    F
    maintenance
    Enables querying sleep, readiness, and resilience data from the Oura API via the Model Context Protocol (MCP), allowing natural language interaction and seamless integration with tools like Claude.
    6
    39
    MIT

  • Oura MCP Server

    koji117
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides access to Oura Ring health data, including sleep, activity, readiness, and stress metrics via the Model Context Protocol. It enables users to query their personal biometric information and daily health summaries through natural language in MCP-compatible clients.
    1,632 npm
    MIT

  • oura-mcp

    louis030195
    A
    license
    B
    quality
    D
    maintenance
    Enables users to query their Oura Ring data (sleep, readiness, activity, heart rate) via natural language through any MCP-compatible LLM.
    4
    22 npm
    1
    MIT