🍵 @daobrew/wellness-mcp

Your coding agent just learned to read your body.

Reads your biometrics (Apple Watch via DaoBrew Health Sync), detects stress patterns, plays therapeutic breathing music with binaural beats, and streams a live dashboard PNG into your chat — all without leaving your editor.

No popups. No app switching. Just music that fades in when you need it. 🎧

---

⚡ Quick Start

npm install -g @daobrew/wellness-mcp
npx daobrew-wellness-setup

Two questions. 30 seconds. Done.

Works with Claude Code, Cursor, Windsurf, and any MCP-compatible agent.

---

🧘 What It Does

You're coding.   →   Agent detects stress.   →   Music fades in + dashboard appears.   →   You keep coding.
                      (real biometric data)       (binaural + breath pacing,                 (stress goes down)
                                                   live HR streamed to chat)

• 📊 Detects stress from real biometrics — HRV, heart rate, sleep, activity
• 🌿 Maps to 5 stress patterns — Tension, Overdrive, Stagnation, Constriction, Depletion
• 🎵 Plays genre-matched music with 4Hz theta binaural beats and breath-paced volume swells
• 🖼 Live dashboard PNG auto-streamed every 2s — HR sparkline, breath bars, session progress
• 🔇 Zero interruption — ambient mode works silently in the background

---

🎮 Usage

On-demand — ask anytime

/stress     →   "Top pattern: 🔥 Overdrive (score 72), HR 88. Want a session?"
/breathe    →   Lo-fi jazz fades in + dashboard appears in chat 🎧
/stop       →   Music stops, summary PNG returned

Ambient — hands-free stress relief

Enable once: "enable ambient mode"

From then on, your agent monitors stress at natural breakpoints. When it detects a spike + you have headphones in, therapeutic music fades in silently. You keep coding. Your HRV recovers.

Say "disable wellness" anytime to turn it off.

---

📱 Data Sources

Source	What You Get	How to Connect
⌚ Apple Watch	HRV, HR, steps, sleep, respiratory + live 1Hz HR during sessions	Install DaoBrew Health Sync on iPhone

(Oura Ring + Google Fit support is deferred post-demo.)

---

🎵 The Five Sounds

Each stress pattern gets its own sound, breathing rate, and vibe:

Pattern	When You Feel...	Sound	What It Does
🌲 Tension	Tense, tight, clenching	Flowing ambient	Releases tension, restores flow
🔥 Overdrive	Wired, restless, can't focus	Warm lo-fi jazz	Cools the mind, settles racing thoughts
⛰️ Stagnation	Sluggish, foggy, unmotivated	Gentle acoustic	Grounds and centers, wakes you up gently
⚔️ Constriction	Shallow breathing, constricted	Nature soundscape	Opens the chest, deepens your breath
🌊 Depletion	Drained, depleted, running on empty	Deep ambient drone	Deep rest, replenishes your reserves

Every track layers a 4Hz theta binaural beat (requires headphones) plus breath-paced volume modulation — the music rises and falls to gently guide your breathing.

💡 On your first session, the agent tells you: "Breathe in as the music rises, out as it fades." After that, your body remembers — no voice prompts, just music.

---

🛠 7 Tools

Tool	What It Does
daobrew_check	Current stress pattern + live dashboard PNG (auto-poll every 2s during a session)
daobrew_breathe	Start a session for a stress pattern (tension / overdrive / stagnation / constriction / depletion)
daobrew_stop	Stop the current session, return final HRV delta + summary PNG
daobrew_history	Recent sessions and trends
daobrew_status	Server mode, headphones, preferences, active session
daobrew_settings	Configure ambient, volume, cooldown, voiceover
daobrew_connect_watch	Pair your Apple Watch via the Health Sync TestFlight app

---

🔒 Privacy

• Agent only sees wellness scores — never raw health records
• Health tokens stored locally at ~/.daobrew/
• Speaker blocklist prevents accidental playback without headphones
• Ambient mode requires explicit opt-in

---

🏗 Architecture

  ⌚ Apple Watch ──→ iPhone Health Sync ──→ DaoBrew Cloud ──→ TCM Scoring Engine
                            │                       ↓
                            │              MCP Server (local)
                            │                       ↓
                            │             Your Coding Agent
                            │                       ↓
                            │              afplay 🎧 + dashboard PNG
                            │              (binaural + breath modulation)
                            ▼
                  POST /session/live-hr ──→ Backend cache ──→ GET /session/live-hr
                                                                       │
                                                              daobrew_check (every 2s)

---

⚙️ Configuration

Talk to your agent:

• "set volume to 0.5"
• "change cooldown to 15 minutes"
• "trust headphones" (skip detection)
• "disable wellness"

Or edit ~/.daobrew/prefs.json.

---

🧑‍💻 Development

git clone <repo>
cd daobrew-wellness-mcp
npm install && npm run build
npm test          # 69 tests
npm run setup     # interactive setup

---

📜 License

MIT

---

Built with 🍵 by DaoBrew. Take a breath. Your code can wait.