Mealie MCP Server
cjam/mealie-mcp
Integra Claude ao Mealie para automação de receitas e planejamento de refeições
Ver no GitHubServidor MCP que expõe a API do Mealie (plataforma de gerenciamento de receitas) como ferramentas Claude. Gerado automaticamente a partir do OpenAPI spec do Mealie via FastMCP, com surface curada para receitas, planos de refeições, listas de compras e metadados relacionados. Permite que Claude acesse e manipule dados de receitas e planejamento de refeições em tempo real.
Instalação
npx convez-ai cjam/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
- Buscar e listar receitas por categoria, tags ou ingredientes
- Gerar planos de refeições semanais automaticamente
- Criar e gerenciar listas de compras a partir de receitas
- Consultar unidades, alimentos cadastrados e organizar receitas
Veredito

Solução prática para conectar Claude ao Mealie sem wrapper manual — geração automática via OpenAPI garante sincronização com atualizações da API. Ideal para quem usa Mealie em NAS/self-hosted e quer automação de planejamento e listas de compras via IA.
README
A tradução para o português deste README ainda está na fila.
mealie-mcp
MCP server for Mealie, generated directly from Mealie's OpenAPI spec via FastMCP. No hand-written endpoint wrappers — tools come from the spec, curated to a meal-planning subset.
How it works
At startup the server:
- Fetches
${MEALIE_BASE_URL}/openapi.jsonfrom your Mealie instance. - Maps a curated subset of routes to MCP tools (see src/routes.py).
- Serves over streamable-HTTP for remote AI clients.
Curated surface (edit INCLUDE_PATTERNS in src/routes.py):
recipes, meal plans, shopping lists/items, categories, tags, foods, units.
Everything else (admin, users, backups…) is excluded.
Configuration
Copy .env.example to .env:
| Var | Required | Default | Notes |
|---|---|---|---|
MEALIE_BASE_URL | yes | — | No trailing slash, no /api. |
MEALIE_API_TOKEN | yes | — | Mealie > User profile > Manage API Tokens. |
MCP_HOST | no | 0.0.0.0 | |
MCP_PORT | no | 8000 | |
MCP_TRANSPORT | no | http | streamable-HTTP. |
LOG_LEVEL | no | INFO |
Develop (devcontainer)
Open the repo in VS Code → "Reopen in Container". It builds Python 3.12 + uv,
runs uv sync, forwards port 8000. Then:
cp .env.example .env # fill in MEALIE_BASE_URL + token
uv run src/server.py
Server at http://localhost:8000/mcp.
Deploy (NAS / Docker)
cp .env.example .env # fill in values
docker compose up -d --build
Point your AI client at http://<nas-host>:8000/mcp.
Connect an MCP client
{
"mcpServers": {
"mealie": {
"url": "http://<nas-host>:8000/mcp"
}
}
}