Wellness Cycle Coach
⚡ One-command install — pick your runtime:
Delx Wellness for Hermes:
npx -y delx-wellness-hermes setupDelx 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. Supports PCOS-aware mode via the cycle_irregular flag (v0.3.3) — accepts cycles 21-90 days, caps confidence at 'low', and returns a luteal_extended placeholder when standard 14-day-luteal math no longer applies.
Related MCP server: Garmin MCP
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 (17)
Tool | Purpose |
| Runtime contract |
| Phases, upstream connectors, metrics |
| Health + stateless reminder |
| What's logged (nothing) vs sent out (nothing) |
| Phase taxonomy + metric catalog |
| Current phase + cycle day + confidence |
| Average cycle length + next-period date |
| Recommendations for any specific phase |
| Phase-aware nutrition for current phase |
| Phase-aware training for current phase |
| Single-call combined report |
| PCOS / irregular-cycle screening from history |
| Minimal getting-started walkthrough |
| Read the shared Delx Wellness profile (read-only) |
| Persist opt-in profile prefs (requires explicit user intent) |
| 11-question onboarding flow for the shared profile |
| Sample request/response for quick exploration |
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 for cycle data — period dates are never persisted; they stay in process memory for the duration of the call and evaporate.
✅ Opt-in local preferences — the
cycle_profile_*tools can persist non-secret wellness preferences (name, goals, devices, training/nutrition context) to~/.delx-wellness/profile.json, but only when the user explicitly asks (cycle_profile_updaterequiresexplicit_user_intent: true). Secrets (tokens, API keys, biomarkers) are rejected at write time.✅ Offline-capable — pure-function computation. No outbound calls.
✅ Tool-arg-only cycle data — the agent passes period history 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.
PCOS / irregular cycles supported via
cycle_irregular: true(v0.3.3), but this is NOT a substitute for clinical care — see clinician for fertility, contraception, or symptom-management decisions.Not specialized for perimenopause or post-pill (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.
📧 Contact & Support
📨 support@delx.ai — general questions, integration help, partnerships
🐛 Bug reports / feature requests — GitHub Issues
🐦 Updates — @delx369 on X
🌐 Site — wellness.delx.ai
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.
This server cannot be installed
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/davidmosiah/wellness-cycle-coach'
If you have feedback or need assistance with the MCP directory API, please join our Discord server