⚡ One-command install — pick your runtime:

• Delx Wellness for Hermes: npx -y delx-wellness-hermes setup
• Delx Wellness for OpenClaw: npx -y delx-wellness-openclaw setup

Overview

Pass in period start dates (from any source — Apple Health Cycle, Garmin women's health, Fitbit female health, or direct user input) and get back the user's current phase plus phase-aware recommendations for nutrition, training, and hydration. Stateless — the MCP itself never persists cycle data.

Try It In 60 Seconds

npx -y wellness-cycle-coach doctor

# Or use the MCP directly via your client:
# {
#   "mcpServers": {
#     "wellness-cycle-coach": {
#       "command": "npx",
#       "args": ["-y", "wellness-cycle-coach"]
#     }
#   }
# }

Then in your agent:

{
  "name": "cycle_full_report",
  "arguments": {
    "history": [
      { "start_date": "2026-04-01" },
      { "start_date": "2026-04-29" }
    ]
  }
}

Returns current phase + nutrition emphasize/moderate/avoid + training style/intensity + hydration target + next-period estimate.

Tools (11)

| Tool | Purpose | |---|---| | cycle_agent_manifest | Runtime contract | | cycle_capabilities | Phases, upstream connectors, metrics | | cycle_connection_status | Health + stateless reminder | | cycle_privacy_audit | What's logged (nothing) vs sent out (nothing) | | cycle_data_inventory | Phase taxonomy + metric catalog | | cycle_estimate_phase | Current phase + cycle day + confidence | | cycle_predict_next_period | Average cycle length + next-period date | | cycle_phase_guidance | Recommendations for any specific phase | | cycle_recommend_nutrition | Phase-aware nutrition for current phase | | cycle_recommend_training | Phase-aware training for current phase | | cycle_full_report | Single-call combined report |

The 4-phase model

| Phase | When | Energy | Nutrition emphasis | Training | |---|---|---|---|---| | menstrual | days 1 → period end (~5) | Lower | Iron + magnesium + omega-3 | Restorative (yoga, walking, mobility) | | follicular | post-period → ovulation - 2 | Rising / peak | Complex carbs + lean protein + fermented foods | Build (strength, sprints, new skills) | | ovulatory | ovulation ± 1 day | Peak | Antioxidants + zinc | Peak (PRs, plyometrics) | | luteal | ovulation + 2 → next period | Falling | B vitamins + magnesium + complex carbs | Endurance + technique |

Why stateless?

Menstrual cycle data is medical-record sensitive. The strongest privacy guarantee is to never store it. Other apps (Flo, Clue) live by hoarding cycle data on their servers; this MCP refuses to participate. The agent passes data in, the coach returns guidance, the data evaporates.

Cross-connector wedge

Apple Health Cycle → period dates       ┐
Garmin women's health → cycle context   ├─→ wellness-cycle-coach → phase + guidance
Fitbit female health → period dates     ┘                                  │
                                                                            │
                                                                            ↓
                                                            wellness-nourish coach
                                                            (phase-aware meal planning)
                                                                            │
                                                            whoop-mcp / garminmcp / ouramcp
                                                            (recovery-aware late-luteal load adjustments)

Privacy

• ✅ Stateless — no period dates persisted.
• ✅ Offline-capable — pure-function computation. No outbound calls.
• ✅ Tool-arg-only data — agent passes data in via the MCP request and it stays in process memory.

Run wellness-cycle-coach doctor to inspect.

What this is NOT

• Not medical advice or diagnosis.
• Not a fertility tracker or contraception aid (consult a clinician).
• Not a replacement for talking to a healthcare provider about painful, abnormal, or absent periods.
• Not specialized for PCOS, perimenopause, post-pill, or other complex contexts (yet — see CONTRIBUTING.md).

Roadmap

• v0.2 — adapters for apple-health-mcp / garminmcp / fitbitmcp so agents can pull period history with one MCP call.
• v0.3 — symptom logging surface + symptom-aware guidance adjustments (cramps → magnesium emphasis, mood drop → B-vitamin emphasis).
• v0.4 — non-English locale support starting with pt-BR.

License

MIT — see LICENSE.

wellness-cycle-coach is independent research-software. Not affiliated with Clue, Flo, Stardust, or any other cycle-tracking app. Not medical advice.