oura-mcp-server: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

pnpm dev          # Start local dev server on http://localhost:8787 (Miniflare, hot reload)
pnpm deploy       # Deploy to Cloudflare Workers (requires wrangler login)
pnpm cf-typegen   # Regenerate worker-configuration.d.ts from wrangler.jsonc bindings
pnpm bootstrap      # Interactive wizard — provisions D1, KV, deploys Worker, copies MCP URL to clipboard
pnpm connect-local  # Set up local credentials + D1 schema (no Cloudflare needed)
pnpm revoke         # Invalidate all active OAuth sessions in KV (Claude re-auths on next use)
pnpm reset          # Clear .dev.vars + .bootstrap-state + wrangler.jsonc (local state only, does not touch KV)
pnpm format         # Prettier (write)
pnpm format:check   # Prettier (check only — used by pre-commit hook)
pnpm lint           # oxlint (typescript/no-explicit-any + recommended rules, --deny-warnings)
pnpm test           # Vitest unit tests
pnpm coverage       # Vitest + v8 coverage (≥90% threshold)
npx tsc --noEmit -p tsconfig.scripts.json   # Type-check the bootstrap script
npx tsc --noEmit                             # Type-check the Worker (no build step — wrangler bundles via esbuild)

Code style

Prettier enforces formatting on every commit (pnpm format:check runs in the pre-commit hook). Config: no semis, trailing commas, 100-char print width. Run pnpm format to auto-fix before committing.

• No section-header comments (// ── Foo ────). Comments only where behavior is non-obvious.

Pre-commit hooks are managed by lefthook (lefthook.yml). They install automatically on pnpm install and run lint + both typechecks in parallel before every commit. To run manually: pnpm lefthook run pre-commit.

D1 migrations:

npx wrangler d1 execute oura-cache --local --file=./migrations/001_init.sql   # local
npx wrangler d1 execute oura-cache --remote --file=./migrations/001_init.sql  # production