Skip to main content
Glama
mealie-mcp

mealie-mcp

by proffalken
README.md
# mealie-mcp

An [MCP](https://modelcontextprotocol.io) server for a [Mealie](https://mealie.io) instance. It lets Claude search, create and update recipes and manage the meal plan.

## Tools

| Tool | What it does |
|---|---|
| `search_recipes` | Search recipes by name or ingredient |
| `get_recipe` | Full recipe, including ingredients and steps |
| `create_recipe` | New recipe with description, ingredients, method steps, notes and source URL |
| `update_recipe` | Change any of the above on an existing recipe (lists are replaced, not appended) |
| `create_recipe_from_url` | Import from a URL; falls back to a stub linking to the URL if scraping fails |
| `get_meal_plan` / `add_to_meal_plan` / `remove_from_meal_plan` | Meal plan management |

Every recipe returned (including those inside meal plan entries) has a `url` field pointing at its page in the Mealie web UI (`<MEALIE_URI>/g/<group>/r/<slug>`).

## Configuration

Set `MEALIE_URI` (e.g. `https://meals.example.com`) and `MEALIE_API_TOKEN`, either in the environment or in a `.env` file.

## Running

```sh
uv sync
uv run mealie-mcp
```

Claude Desktop config:

```json
"mealie": {
  "command": "/path/to/MealieMCP/.venv/bin/mealie-mcp",
  "env": { "MEALIE_URI": "...", "MEALIE_API_TOKEN": "..." }
}
```

## Tests

```sh
uv run pytest
```

## Licence

MIT. See [LICENSE](LICENSE).

TDQS

A3.5/5.0

Scored across 8 tools

Disambiguation5/5

Each tool targets a distinct action/resource: recipe search, retrieval, creation, update, URL import, and three meal-plan operations. The split between create_recipe and create_recipe_from_url is clearly explained, so misselection is unlikely.

Naming Consistency5/5

All tools follow a predictable verb_noun pattern (search_recipes, get_recipe, create_recipe, update_recipe, get_meal_plan, add_to_meal_plan, remove_from_meal_plan). Minor pluralization differences are natural and do not hurt readability.

Tool Count5/5

Eight tools is well-scoped for a Mealie recipe and meal-plan server. Each tool has a clear role, and there is no obvious padding.

Completeness4/5

Core recipe and meal-plan workflows are covered, including URL import and meal-plan removal. However, recipe deletion is missing, and there is no explicit meal-plan update operation, leaving minor lifecycle gaps.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues