oura-mcp

A remote MCP server that plugs your Oura Ring data into Claude, running on Cloudflare Workers. No laptop left on. No server to babysit. Free to host.

✨ What you get

"How did I sleep this week, and what is dragging my readiness down?"

Ask in plain language. Claude pulls the numbers straight from your ring and answers.

Related MCP server: Oura MCP Server

🧠 How it works

flowchart LR
    A["🤖 Claude<br/>web, desktop, mobile"] -- "MCP over HTTPS" --> B["☁️ Your Cloudflare Worker<br/>oura-mcp"]
    B -- "OAuth2 bearer token" --> C["💍 Oura API v2"]
    B <-- "rotating tokens" --> D[("🔐 Durable Object")]

• 🏠 Your own deployment. It runs in your Cloudflare account with your Oura API app. Your health data never passes through anyone else's server.

• 🔒 Read only. The server never writes anything to your Oura account.

• 🔁 Safe token rotation. Oura refresh tokens are single use. One Durable Object rotates them, so concurrent requests cannot break your login.

• 🧰 Raw data plus smart tools. oura_data reads 19 collections, and four analysis tools do the maths for you.

• ✅ Tested. The analysis code is pure functions with a unit test suite that runs in CI on every push.

📸 See it in action

Illustrative examples with sample data. Your own numbers come live from your ring.

🧠 Smart tools

You do not have to ask Claude to crunch raw JSON. These tools return ready-made answers:

Daily collections take start_date and end_date. Time series (heartrate, ring_battery_level) take start_datetime and end_datetime. Any record can be fetched with document_id, and large results page with next_token.

🚀 Setup in 6 steps

You need: a free Cloudflare account, an Oura account, and Node.js 18 or newer.

1. Create an Oura API app at developer.ouraring.com. You will add the redirect URI in step 4.

2. Deploy (or use the button above)

git clone https://github.com/mehmetaktug/oura-mcp && cd oura-mcp
npm install
npx wrangler login
npx wrangler deploy

Wrangler prints your URL, for example https://oura-mcp.<your-subdomain>.workers.dev.

3. Set your secrets

npx wrangler secret put OURA_CLIENT_ID
npx wrangler secret put OURA_CLIENT_SECRET
npx wrangler secret put MCP_SECRET     # long random string: openssl rand -hex 24

4. Add the redirect URI to your Oura app:

https://<your-worker-host>/callback

5. Connect your ring. Open this in a browser and approve access:

https://<your-worker-host>/<MCP_SECRET>/login

6. Add the connector. In claude.ai open Settings → Connectors → Add custom connector, paste the URL below and choose No sign-in:

https://<your-worker-host>/<MCP_SECRET>/mcp

That is it. Start a new chat and ask about your sleep. 🎉

🛡️ Security model

🧪 Local development

cp .dev.vars.example .dev.vars   # fill in the values
npx wrangler dev
npm test                          # run the unit tests

Use http://localhost:8787/callback as an extra redirect URI in your Oura app while testing.

🩹 Troubleshooting

🗺️ Ideas for contributions

• More analysis tools: correlations with tags, anomaly detection, stress and recovery balance

• Optional API key header authentication

• Webhook support for push updates

• Response trimming for token efficiency

PRs and issues are welcome. ⭐ If this is useful to you, a star helps others find it.

⚖️ Disclaimer

Unofficial community project. Not affiliated with or endorsed by Oura. Your data is yours: use at your own risk and never share your secret URL.

You run your own copy with your own Oura API app, so you are responsible for following the Oura API and MCP Agreement and applicable privacy laws.

📄 License

MIT