delx-wellness
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Warn
- fs module — File system access in .github/workflows/ci.yml
- network request — Outbound network request in scripts/collect-growth-metrics.mjs
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Public registry for local-first wellness MCP connectors: wearables, recovery, training, nutrition and the Delx Wellness Hermes profile.
Delx Wellness
Open-source MCP connectors for wearables, recovery, training and nutrition.
Give your AI agent your sleep, HRV, workouts and food — all local-first, all read-only.
What is this? A registry of 11 open-source MCP servers that turn your wearables and nutrition logs into context any AI agent can read — with zero data ever leaving your machine.
⭐ If this helps your agent workflow, star this hub.
Stars make the connector map easier for AI builders to find, and this is the canonical repo for the Delx Wellness ecosystem.
Start here
| Goal | Use this | Command |
|---|---|---|
| Install the whole wellness stack for Hermes | delx-wellness-hermes |
npx -y delx-wellness-hermes setup |
| Track food, barcode scans, hydration and meal summaries | wellness-nourish |
npx -y wellness-nourish doctor |
| Add recovery, strain, sleep and HRV | whoop-mcp |
npx -y whoop-mcp-unofficial setup |
| Add Body Battery, sleep, stress and training readiness | garminmcp |
npx -y garmin-mcp-unofficial setup --auth |
| Browse the human-friendly site | delx-wellness-site |
wellness.delx.ai |
Agents should start with agent_manifest, connection_status or capabilities when a connector exposes them. Humans should start with the Hermes profile if they want the Telegram-style daily workflow.
✨ The 11 connectors
Each connector is a standalone npm package. Install one or all eleven — they coexist and the agent reconciles overlapping signals (WHOOP, Garmin, Apple Health, Samsung Health and Google Health all reporting sleep, etc.).
🚀 Quick Start — one command for the whole stack
The fastest path is the Hermes profile pack. One command creates a local-first wellness profile with onboarding, skills, MCP presets and setup checks for all 11 connectors:
npx -y delx-wellness-hermes setup
hermes -p delx-wellness
That's it. The setup wizard walks you through choosing which providers to wire up, runs a smoke test against the local Nourish connector (no OAuth required), and prints the next commands for model setup and per-provider auth.
📦
delx-wellness-hermesis the agent profile pack — it preconfigures everything below in a dedicated Hermes profile so you don't have to glue 11 MCP configs by hand.
| Runtime | Profile pack | Repository | Page |
|---|---|---|---|
| Hermes | Delx Wellness for Hermes | delx-wellness-hermes |
wellness.delx.ai/hermes |
🔌 Or wire connectors individually
Each connector is a standalone npm package with its own guided setup CLI — use this path when you want to drop a single provider into Claude Desktop, Cursor, ChatGPT Desktop or any other MCP client.
npx -y whoop-mcp-unofficial setup && npx -y whoop-mcp-unofficial auth
npx -y oura-mcp-unofficial setup && npx -y oura-mcp-unofficial auth
npx -y garmin-mcp-unofficial setup && npx -y garmin-mcp-unofficial auth --install-helper
npx -y strava-mcp-unofficial setup && npx -y strava-mcp-unofficial auth
npx -y fitbit-mcp-unofficial setup && npx -y fitbit-mcp-unofficial auth
npx -y google-health-mcp-unofficial setup && npx -y google-health-mcp-unofficial auth
npx -y withings-mcp-unofficial setup && npx -y withings-mcp-unofficial auth
npx -y apple-health-mcp-unofficial setup --export-path /path/to/export.zip
npx -y samsung-health-mcp-unofficial setup --export-path /path/to/SamsungHealth
npx -y polar-mcp-unofficial setup && npx -y polar-mcp-unofficial auth
npx -y wellness-nourish manifest
Then drop one of the client config examples into your AI client:
| Client | Config | Notes |
|---|---|---|
| Claude Desktop | examples/claude-desktop.json |
Drop into claude_desktop_config.json |
| Cursor | examples/cursor.json |
Drop into Cursor's MCP settings |
| Windsurf | examples/windsurf.json |
Same shape as Cursor |
| Hermes | examples/hermes.md |
YAML + skill files (or use the profile pack above) |
| Generic / ChatGPT / OpenClaw | examples/generic-mcp.md |
Standard mcpServers shape |
🏗️ How it fits together
flowchart LR
subgraph A[" Your AI Agent "]
direction LR
Claude[Claude]
Cursor[Cursor]
Hermes[Hermes]
ChatGPT[ChatGPT Desktop]
end
subgraph L[" Local on your machine "]
direction TB
MCP[delx-wellness-hermes profile<br/>or standalone MCP configs]
W[whoop-mcp]
O[oura-mcp]
G[garmin-mcp]
S[strava-mcp]
F[fitbit-mcp]
GH[google-health-mcp]
Wi[withings-mcp]
AH[apple-health-mcp]
SH[samsung-health-mcp]
P[polar-mcp]
N[nourish]
end
subgraph P2[" Provider APIs "]
direction TB
WHOOP[WHOOP API]
OURA[Oura API]
GARMIN[Garmin Connect]
STRAVA[Strava API]
FITBIT[Fitbit API]
GOOGLE[Google Health API]
WITHINGS[Withings API]
AHE[Apple Health export.zip]
SHE[Samsung Health CSV export]
POLAR[Polar Accesslink]
LOCAL[Local food DB]
end
A --> MCP
MCP --> W & O & G & S & F & GH & Wi & AH & SH & P & N
W --> WHOOP
O --> OURA
G --> GARMIN
S --> STRAVA
F --> FITBIT
GH --> GOOGLE
Wi --> WITHINGS
AH --> AHE
SH --> SHE
P --> POLAR
N --> LOCAL
style L fill:#0F172A,stroke:#0EA5A3,color:#fff
style A fill:#0F172A,stroke:#10B981,color:#fff
style P2 fill:#0F172A,stroke:#7C3AED,color:#fff
One agent → one local profile → eleven connectors → your provider data. Tokens never leave your machine.
🧭 Which connector should I install first?
Have a WHOOP? → start with whoop-mcp (recovery, HRV, sleep, strain)
Have a Garmin? → start with garminmcp (Body Battery, training readiness, HRV)
Have an Oura? → start with ouramcp (readiness, sleep, activity, HRV)
Have Withings devices? → start with withingsmcp (body measures, sleep, activity, heart)
Have an Apple Health export?→ add apple-health-mcp (local export activity, sleep, HRV, workouts)
Have a Galaxy Watch export? → add samsung-health-mcp (local CSV activity, sleep, HRV, workouts)
Have a Polar device? → start with polarmcp (Nightly Recharge, training load, PPI/HRV)
Run/ride/swim a lot? → add strava-mcp (activities, streams, routes)
Just bought a Fitbit? → add fitbitmcp (activity, sleep, heart, HRV)
Migrating Fitbit to Google?→ add google-health-mcp (Google Health API v4, rollups, reconciled streams)
Tracking food? → add wellness-nourish (food search, barcode lookup, intake, hydration)
Multiple devices? → install several. Each is independent and read-only.
The connectors are designed to coexist. When two providers cover the same signal (e.g. WHOOP and Garmin both report sleep), each tool returns provider-tagged data and your agent reconciles them.
💡 Why local-first?
Your wearable data is the most personal context an agent can have — sleep stages, heart rhythm, recovery scores, what you ate. Sending all of that through a hosted vault you don't control is the wrong default.
Delx Wellness flips it:
- 🔒 Tokens stay on your machine. OAuth completes locally; refresh tokens live in your OS keychain or a
~/.configfile you own. - 📖 Read-only by design. Every connector is read-only. There is no "write to your Apple Health" tool, no surprise side effects.
- 🧱 Standalone packages. Each connector is a separate npm package with a clear scope. Audit one without auditing nine.
- 🤝 Vendor-neutral. You can mix providers, swap one out, or remove all of them without anything breaking on a hosted side.
- 🌐 No phone-home. No analytics, no telemetry, no usage reporting baked into the connectors themselves.
The hosted commercial layer (token vault, billing, rate limits) may stay private — but the connectors that touch your data are open source, on this registry, forever.
📊 Open-source boundary
| Layer | Public | Notes |
|---|---|---|
| Local provider connectors | ✅ | 11 individual MCP servers (WHOOP · Strava · Fitbit · Google Health · Garmin · Oura · Withings · Apple Health · Samsung Health · Polar · Nourish) |
| Hermes profile pack | ✅ | delx-wellness-hermes — one-command setup |
| Connector registry & docs | ✅ | This repository |
| Normalized schemas | ✅ | Stable shared shapes for cross-provider tools — schemas/ |
| Hosted hub API | ⏳ | May remain private during product-market fit |
| Token vault, billing, rate limits | ⏳ | Sensitive commercial and security surface |
| Real user health data | ❌ | Never committed to GitHub |
Tiers and trust levels are defined in docs/connector-quality-standard.md. Machine-readable catalog: registry.json.
📚 Reference docs
- Connector quality standard — release and trust checklist
- Provider status — current matrix and risks
- Privacy model — local-first privacy boundary and hosted-hub considerations
- Normalized schema — shared cross-provider wellness snapshot shape
- Growth playbook and MCP directory submissions — ecosystem ops
⚠️ What this is not
- Not a medical device.
- Not medical advice, diagnosis, treatment or emergency support.
- Not a promise that every future hosted product will be open source.
- Not a place for real user health exports, OAuth tokens, API secrets or private deployment files.
🧭 Direction
The practical near-term path:
- Keep provider MCPs independently installable.
- Use this repository as the public connector registry and documentation hub.
- Define shared normalized schemas before building cross-provider tools.
- Keep hosted/commercial infrastructure private until the product direction is proven.
👤 Built by
David Batista — founder of Delx, building protocol layers for autonomous AI agents.
Follow on X: @delx369 · Site: wellness.delx.ai
📜 License
MIT — see LICENSE.
Delx Wellness is an open-source project. WHOOP, Oura, Garmin, Strava, Fitbit, Google Health, Withings, Apple Health, Samsung Health and Polar are trademarks of their respective owners. None of the connectors in this registry are affiliated with, endorsed by, or supported by those companies.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found