Mealie MCP Server
alexander-wenzel-dev/mealie-mcp
Gerencie receitas e planos de refeição via IA com Mealie MCP
Ver no GitHubServidor MCP que expõe a API REST do Mealie como ferramentas utilizáveis por clientes MCP como Claude. Permite ler, criar e gerenciar receitas, planos de refeições e listas de compras diretamente de assistentes de IA através de uma instância Mealie que você controla.
Instalação
npx convez-ai alexander-wenzel-dev/mealie-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Organizar receitas e planos de refeições através de conversas com Claude
- Automatizar criação e categorização de receitas em massa
- Consultar e gerenciar listas de compras programaticamente
Veredito

Servidor MCP bem estruturado para integrar Mealie com assistentes de IA. Em desenvolvimento ativo com cobertura progressiva das operações da API; recomendado para quem já usa Mealie e quer automação via Claude, com entendimento que ainda não tem versão estável publicada.
README
A tradução para o português deste README ainda está na fila.
mealie-mcp
An MCP server for the Mealie recipe manager.
The server wraps the Mealie REST API and exposes its operations as MCP tools, so an MCP-capable assistant like Claude can read, create, and manage recipes on a Mealie instance you control.
Status: early development. Not yet published to PyPI.
Requirements
- Python 3.14
- uv
- A reachable Mealie instance and a Mealie API token
Install
Clone the repo so an MCP client can launch the server from your local checkout.
git clone https://github.com/alexander-wenzel-dev/mealie-mcp.git
cd mealie-mcp
uv sync
Configure
Register the server in your MCP client. The example below works for any client that uses the standard MCP server config (Claude Desktop, Cursor, and others). Replace /absolute/path/to/mealie-mcp with the path to your clone.
{
"mcpServers": {
"mealie": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/mealie-mcp", "run", "mealie-mcp"],
"env": {
"MEALIE_BASE_URL": "https://mealie.example.com",
"MEALIE_API_TOKEN": "replace-me"
}
}
}
}
For Claude Code:
claude mcp add mealie --env MEALIE_BASE_URL=https://mealie.example.com --env MEALIE_API_TOKEN=replace-me -- uv --directory "$(pwd)" run mealie-mcp
Tools
The server exposes MCP tools grouped by Mealie OpenAPI tag. New groups are added as the project grows.
| Group | Coverage |
|---|---|
recipe_crud | Create, read, list, duplicate, scrape from URL or JSON-LD, patch the last-made timestamp, and delete recipes. |
recipe_comments | Create, read, list, update, and delete recipe comments. |
organizer_categories | Create, read by id or slug, list, update, and delete recipe categories. |
organizer_tags | Create, read by id or slug, list, update, and delete recipe tags. |
Regenerate the API client
The Mealie OpenAPI spec is cached at spec/mealie-openapi.json and pinned in pyproject.toml. Regenerate the typed client from the cached spec:
uv run regen-client # use the cached spec
uv run regen-client --update # refetch from $MEALIE_BASE_URL/openapi.json and re-pin
Run tests
uv run pytest # unit tests
uv run pytest -m live # live tests, require a local .env
License
MIT. See LICENSE.