Wellness Nourish

Name: Wellness Nourish
Author: davidmosiah

@davidmosiah

Repository

About Wellness Nourish

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "nourish": {
      "command": "npx",
      "args": [
        "-y",
        "wellness-nourish"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Wellness Nourish?

Wellness Nourish is a local-first MCP server for nutrition search, barcode lookup, barcode photo lookup, photo-assisted meal estimation, intake logging, hydration tracking, goal setting, exports, daily and weekly summaries, personal meal memory, and coach-style nutrition workflows. It runs over stdio or Streamable HTTP, requires no OAuth, and keeps tokens on your machine.

How to use Wellness Nourish?

Install via npm and run the stdio MCP server with npm start or via CLI commands such as npx -y wellness-nourish search banana. For Streamable HTTP, run node dist/index.js --http. One‑command setup is available for Hermes (npx -y delx-wellness-hermes setup) and OpenClaw (npx -y delx-wellness-openclaw setup). Configure environment variables like FDC_API_KEY and NOURISH_OFF_ENABLED for optional providers, or use NOURISH_FIXTURE_MODE=1 to demo offline with bundled fixtures.

Key features of Wellness Nourish

Food search via USDA FoodData Central
Packaged‑food barcode lookup via Open Food Facts
Local barcode image decoding with ZXing
Photo‑assisted meal estimation (agent describes visible items)
Local estimator with a pt‑BR/Brazilian‑food catalog
Intake logging with preview mode (log --preview)
Hydration and goal tracking
Daily and weekly summaries, exports, meal memory
Coach‑style nutrition workflows (“what should I eat now?”)

Use cases of Wellness Nourish

AI agents helping users log meals by text or barcode
Barcode scanning from photos (supports image paths, base64, data URIs)
Meal photo estimation with portion confirmation
Daily coaching and next‑meal suggestions
Personal meal memory for repeated meals
Hydration and goal management

FAQ from Wellness Nourish

What makes Wellness Nourish “local‑first”?

Tokens and data never leave your machine. The server runs on your local device, uses local storage for logs and goals, and does not require OAuth or hosted sync.

Does Wellness Nourish require an API key?

No. The primary food search provider (USDA FoodData Central) can be used with an optional FDC_API_KEY. Open Food Facts for barcode lookup requires enabling NOURISH_OFF_ENABLED but no key. Fixture mode (NOURISH_FIXTURE_MODE=1) works completely offline without any keys.

Can Wellness Nourish be used offline?

Yes. With NOURISH_FIXTURE_MODE=1, the server serves bundled fixture data so you can see every response shape without network access.

What transports are supported?

Supports stdio (default for MCP clients) and Streamable HTTP at POST /mcp when started with --http.

Does Wellness Nourish provide medical advice?

No. It is a conservative tracking estimator; all nutrition values are estimates and include confidence scores and warnings. It does not provide hosted sync, autonomous photo upload, recipe generation, or medical advice.