Skip to main content
Glama
davidmosiah

Wellness Cycle Coach

One-command install — pick your runtime:


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

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

cycle_irregular_check

PCOS / irregular-cycle screening from history

cycle_quickstart

Minimal getting-started walkthrough

cycle_profile_get

Read the shared Delx Wellness profile (read-only)

cycle_profile_update

Persist opt-in profile prefs (requires explicit user intent)

cycle_onboarding

11-question onboarding flow for the shared profile

cycle_demo

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_update requires explicit_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

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.

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Latest Blog Posts

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