Oura MCP server

Oura MCP server

Lies deine deinen Oura-Ring über Claude.ai und Claude Code aus: Schlaf mit den vollständigen Perioden hinter dem Score, Readiness, Aktivität, Workouts, Herzfrequenz, Stress, SpO2, Resilienz, kardiovaskuläres Alter, Blutdruck, VO2max, Empfehlungen zur Schlafenszeit, Tags und Ruhemodus. Er spricht mit der dokumentierten Oura-API v2 und schaltet ein OAuth-2.1-Login vor, damit du sie als benutzerdefinierten Connector in Claude.ai hinzufügen kannst. Claude Code kann stattdessen ein einfaches Token verwenden.

Warum nicht das npm-Paket

Die Geschichte begann als Wrapper um einen @daver/oura-mcp und hat ihn ersetzt, weil dieses Paket bei den meisten Anfragen nichts zurückgibt. Es fragt Tagesbereiche als start_date == end_date ab, und Oura antwortet darauf nicht so, wie die Begriffe es nahelegen:

• sleep filtert nach bedtime_start in UTC; eine Nacht, die um 00:31 Ortszeit (UTC+3) beginnt, landet auf dem vorherigen UTC-Tag und fällt aus dem Tagesfenster ihres eigenen Tages heraus. Auch. daily_activity und workout behandeln end_date als exklusiv, wodurch ein gleitender Zeitraum am selben Tag die Breite null hat.

Das Ergebnis ist stillschweigend falsch: Bei jedem Einzel-Tagesaufruf liefert oura_sleep einen Score mit einem leeren periods-Array, oura_activity liefert null und oura_workouts liefert []. Nichts gibt einen Fehler zurück, sodass es wie „keine Daten aufgezeichnet“ wirkt statt „die Frische war falsch“. Dieser Server erweitert den Zeitraum auf beiden Seiten und filtert anhand des day-Felds des jeweiligen Datensatzes zurück, was zeitzonzenkorrekt ist. Er folgt außerdem next_token, bis alle Seiten durchlaufen sind, statt stillschweigend nur eine Seite zurückzugeben.

Werkzeuge

Jedes datumsbezogene Tool nimmt eine optionale date im Format YYYY-MM-DD an und standardmäßig ist der heutige Tages. Oura verbucht eine Nacht unter dem Tag, an dem du aufwachtst.

Für dich oura_vo2_max, oura_sleep_time und oura_kardiovaskulär_age sind spärlich von Natur: Oura berechnet man periodisch, nicht täglich, fällt daher ist ein leeres Ergebnis normal und kein Synchronisierungsfehler.

Wie alles zusammenspielt

Claude.ai / Claude Code
        |  HTTPS
   Cloudflare Tunnel, or any proxy that gives you HTTPS
        |
   nginx  127.0.0.1:8441
        |
   auth-server.js  :8442    handles the login and the tokens
        |
   oura-mcp  :8440          streamable HTTP, local only
        |
   api.ouraring.com

Die Ports 8440-8442 liegen so, dass sie die anderen MCPs auf diesem Host nicht behindern. Der Server :8440 hat kein eigenes Login und weigert sich, an etwas anderes als Loopback zu binden, sodass er nur über die Login-Schicht erreichbar ist.

Einrichtung

Das braucht Python 3.12 oder neuer und Node für die Login-Schicht.

python3 -m venv .venv
.venv/bin/pip install -e .
npm install --omit=dev

mkdir -p ~/.config/oura-mcp && chmod 700 ~/.config/oura-mcp
echo "OURA_TOKEN=your-personal-access-token" > ~/.config/oura-mcp/env
chmod 600 ~/.config/oura-mcp/env

CONFIG_DIR=~/.config/oura-mcp node set-password.js 'your-password-here'
openssl rand -hex 32 > ~/.config/oura-mcp/token
chmod 600 ~/.config/oura-mcp/token

Hole deinen Oura-Token von cloud.ouraring.com.

Dann fülle in systemd/*.service und in den nginx/oura-mcp.confdie WerteYOUR_USER` und den Hostname aus, und:

sudo cp systemd/*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now oura-mcp oura-mcp-auth
sudo cp nginx/oura-mcp.conf /etc/nginx/sites-enabled/oura-mcp
sudo nginx -t && sudo systemctl reload nginx

Richte einen Tunnel oder einen HTTPS-Proxy auf 127.0.0.1:8441 aus. OAuth braucht HTTPS.

Teste nach außen: Die Discovery sollte Metadaten zurückgeben, und /mcp ohne Token muss 401 liefern.

curl https://your-host/.well-known/oauth-authorization-server
curl -o /dev/null -w '%{http_code}\n' -X POST https://your-host/mcp

Verbinden

Claude.ai: Einstellungen, Connectors, Benutzerdefinierten Connector hinzufügen, https://your-host/mcp, Client-ID und Secret leer lassen.

Claude Code:

claude mcp add --transport http oura https://your-host/mcp \
  --header "Authorization: Bearer $(cat ~/.config/oura-mcp/token)" --scope user

Alternativ über stdio entnehmen, ohne die Login-Schicht:

OURA_TOKEN=your-token .venv/bin/oura-mcp

Danksagungen

Die Login-Schicht stammt von stellecode/obsidian-remote-mcp.