FelixWag

Oura Ring MCP — Data skill for Claude Code

Data community

Talk to your Oura Ring data through Claude.

How to install Oura Ring MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open FelixWag/oura-ring-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Oura Ring MCP does

Talk to your Oura Ring data through Claude. Local SQLite mirror, 14 MCP tools, OAuth2, ~5-minute setup.

Alternatives in Data

  • Private GPT — Complete API layer for private AI applications on local models: RAG, skills, tools, MCP, text-to-sql, and more 57.5k ★
  • Claude Code Memory Setup — Up to 71.5x fewer tokens per session on Claude Code with Obsidian + Graphify 947 ★
  • Aoci Code — Local-first MCP server + CLI in Go: a persistent, governed codebase index that distills code and database sche 443 ★

README

oura-ring-mcp

Natural-language access to your Oura data through Claude. Local SQLite mirror, natural-language annotations, and MCP tools for actually asking questions about your health data.

[![CI](https://github.com/FelixWag/oura-ring-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/FelixWag/oura-ring-mcp/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![MCP](https://img.shields.io/badge/MCP-compatible-blue.svg)](https://modelcontextprotocol.io) [![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](https://github.com/FelixWag/oura-ring-mcp/actions) [![Node](https://img.shields.io/badge/Node-20%2B-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org)

![Demo: logging beers and asking Claude about next-day readiness recovery](docs/demo.gif)

Oura already tracks sleep, readiness, activity, heart rate, stress, and tags.

But the interesting questions are usually more personal:

  • "Does alcohol actually affect my readiness?"
  • "Do late coffees hurt my deep sleep?"
  • "Why has my energy been low lately?"
  • "How long do I take to recover after travel or hard workouts?"
  • "What changed on the nights where I slept really well?"

`oura-ring-mcp` lets Claude analyze your Oura data locally through MCP, with your own annotations and context stored in SQLite.

You can log things naturally:

  • "I had 2 beers Thursday from 7pm to midnight. Log it."
  • "I was sick from Monday to Wednesday."
  • "Late coffee today at 4pm."

And then actually ask questions about the patterns behind your health data.

Everything is local-first. After sync, most queries run against your local SQLite mirror instead of repeatedly hitting the Oura API.

Sensitive data warning: this project works with personal health data. Tokens and synced data are stored locally at `~/.config/oura-ring-mcp/` with `0600` permissions and are never sent anywhere by this software except to `api.ouraring.com` for Oura API reques