# Nutrition Mcp

> A remote MCP server for personal nutrition tracking — log meals, track macros, and review nutrition history through conversation.

- **Type:** MCP server
- **Install:** `agentstack add mcp-akutishevsky-nutrition-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [akutishevsky](https://agentstack.voostack.com/s/akutishevsky)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [akutishevsky](https://github.com/akutishevsky)
- **Source:** https://github.com/akutishevsky/nutrition-mcp
- **Website:** https://nutrition-mcp.com

## Install

```sh
agentstack add mcp-akutishevsky-nutrition-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Nutrition MCP

A remote MCP server for personal nutrition tracking — log meals, track macros, and review nutrition history through conversation.

[Help me pay for the servers on Patreon][patreon]

[patreon]: https://patreon.com/akutishevskyi?utm_medium=unknown&utm_source=join_link&utm_campaign=creatorshare_creator&utm_content=copyLink

## Quick Start

Already hosted and ready to use — just connect it to your MCP client:

```
https://nutrition-mcp.com/mcp
```

**On Claude.ai:** Customize → Connectors → + → Add custom connector → paste the URL → Connect

On first connect you'll be asked to register with an email and password. Your data persists across reconnections.

## Demo

[](https://youtube.com/shorts/Y1EHbfimQ70)

Read the story behind it: [How I Replaced MyFitnessPal and Other Apps with a Single MCP Server](https://medium.com/@akutishevsky/how-i-replaced-myfitnesspal-and-other-apps-with-a-single-mcp-server-56ca5ec7d673)

## Tech Stack

- **Bun** — runtime and package manager
- **Hono** — HTTP framework
- **MCP SDK** — Model Context Protocol over Streamable HTTP
- **Supabase** — PostgreSQL database + user authentication
- **OAuth 2.0** — authentication for Claude.ai connectors

## MCP Tools

| Tool                      | Description                                                                                              |
| ------------------------- | -------------------------------------------------------------------------------------------------------- |
| `log_meal`                | Log a meal with description, type, calories, macros, notes                                               |
| `lookup_barcode`          | Look up a packaged product's verified macros by barcode via Open Food Facts (read from a photo or typed) |
| `get_meals_today`         | Get all meals logged today                                                                               |
| `get_meals_by_date`       | Get meals for a specific date (YYYY-MM-DD)                                                               |
| `get_meals_by_date_range` | Get meals between two dates (inclusive)                                                                  |
| `get_nutrition_summary`   | Daily nutrition totals + goal progress for a date range                                                  |
| `update_meal`             | Update any fields of an existing meal                                                                    |
| `delete_meal`             | Delete a meal by ID                                                                                      |
| `set_nutrition_goals`     | Set daily calorie, macro, and water targets                                                              |
| `get_nutrition_goals`     | Get the current daily targets                                                                            |
| `get_goal_progress`       | Get intake vs. targets for a given day (default: today)                                                  |
| `log_water`               | Log a hydration entry in milliliters                                                                     |
| `get_water_today`         | Get today's water intake total and entries                                                               |
| `get_water_by_date`       | Get water intake for a specific date                                                                     |
| `delete_water`            | Delete a water log entry by ID                                                                           |
| `get_trends`              | 7/14/30-day averages, std dev, streaks, day-of-week, best/worst day                                      |
| `get_meal_patterns`       | Pre-aggregated behavioural patterns (breakfast effect, late dinner, weekend vs weekday, outliers)        |
| `export_meals`            | Export all meals as a CSV and return a 60-minute download link                                           |
| `set_timezone`            | Set the user's IANA timezone (e.g. `America/Los_Angeles`)                                                |
| `get_timezone`            | Get the user's configured timezone                                                                       |
| `delete_account`          | Permanently delete account and all associated data                                                       |

## MCP Resources

| URI                          | Description                                                                       |
| ---------------------------- | --------------------------------------------------------------------------------- |
| `nutrition://weekly-summary` | Rolling 7-day digest (averages vs targets, best/roughest day) for proactive pulls |

## Self-hosting

### 1. Supabase setup

1. Create a [Supabase](https://supabase.com) project.
2. Enable **Email Auth** (Authentication → Providers → Email) and disable email confirmation.
3. Apply the schema. The full schema lives in [`supabase/migrations/`](supabase/migrations/). With the [Supabase CLI](https://supabase.com/docs/guides/local-development/cli/getting-started):

    ```bash
    supabase link --project-ref 
    supabase db push
    ```

    This creates every table, index, RLS policy, and foreign key the app needs. No local Postgres is involved — migrations run against your hosted project.

4. Copy the **service role key** from Project Settings → API and use it as `SUPABASE_SECRET_KEY`.

### 2. Environment variables

| Variable               | Description                                                                   |
| ---------------------- | ----------------------------------------------------------------------------- |
| `SUPABASE_URL`         | Your Supabase project URL                                                     |
| `SUPABASE_SECRET_KEY`  | Supabase service role key (bypasses RLS)                                      |
| `OAUTH_CLIENT_ID`      | Random string for OAuth client identification                                 |
| `OAUTH_CLIENT_SECRET`  | Random string for OAuth client authentication                                 |
| `GOOGLE_CLIENT_ID`     | _(optional)_ Google OAuth client ID for "Sign in with Google"                 |
| `GOOGLE_CLIENT_SECRET` | _(optional)_ Google OAuth client secret                                       |
| `OFF_USER_AGENT`       | Open Food Facts User-Agent for barcode lookups, in the form `AppName (email)` |
| `PORT`                 | Server port (default: `8080`)                                                 |

> **Note:** The HTML files in `public/` include a Google Analytics tag (`G-1K4HRB2R8X`). If you're self-hosting, remove or replace the gtag snippet in `public/index.html`, `public/login.html`, and `public/privacy.html`.

Generate OAuth credentials:

```bash
openssl rand -hex 16   # use as OAUTH_CLIENT_ID
openssl rand -hex 32   # use as OAUTH_CLIENT_SECRET
```

### 3. Google sign-in (optional)

Email/password works out of the box. To also offer **"Continue with Google"**,
follow [`docs/google-auth-setup.md`](docs/google-auth-setup.md) to create a
Google OAuth client, enable the Google provider in Supabase, and set
`GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET`.

## Development

```bash
bun install
cp .env.example .env   # fill in your credentials
bun run dev             # starts with hot reload on http://localhost:8080
```

## Connect to Claude.ai

1. Open [Claude.ai](https://claude.ai) and click **Customize**
2. Click **Connectors**, then the **+** button
3. Click **Add custom connector**
4. Fill in:
    - **Name**: Nutrition Tracker
    - **Remote MCP Server URL**: `https://nutrition-mcp.com/mcp`
5. Click **Connect** — sign in or register when prompted
6. After signing in, Claude can use your nutrition tools. If you reconnect later, sign in with the same email and password to keep your data.

## API Endpoints

| Endpoint                                      | Description                            |
| --------------------------------------------- | -------------------------------------- |
| `GET /health`                                 | Health check                           |
| `GET /.well-known/oauth-authorization-server` | OAuth metadata discovery               |
| `POST /register`                              | Dynamic client registration            |
| `GET /authorize`                              | OAuth authorization (shows login page) |
| `POST /approve`                               | Login/register handler                 |
| `POST /token`                                 | Token exchange                         |
| `GET /favicon.ico`                            | Server icon                            |
| `ALL /mcp`                                    | MCP endpoint (authenticated)           |

## Deploy

The project includes a `Dockerfile` for container-based deployment.

1. Push your repo to a hosting provider (e.g. DigitalOcean App Platform)
2. Set the environment variables listed above
3. The app auto-detects the Dockerfile and deploys on port `8080`
4. Point your domain to the deployed URL

## License

[MIT](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [akutishevsky](https://github.com/akutishevsky)
- **Source:** [akutishevsky/nutrition-mcp](https://github.com/akutishevsky/nutrition-mcp)
- **License:** MIT
- **Homepage:** https://nutrition-mcp.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-akutishevsky-nutrition-mcp
- Seller: https://agentstack.voostack.com/s/akutishevsky
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.