MCP server for Mealie

Connects AI assistants to Mealie through the Model Context Protocol: search and write recipes, manage shopping lists, and plan meals.

One Docker container can serve a whole household or team, with each person acting as their own Mealie user.

Quick start: stdio

Create an API token in Mealie under Profile → API Tokens, then add this to your MCP client:

{
  "mcpServers": {
    "mealie": {
      "command": "npx",
      "args": ["-y", "@daften/mealie-mcp"],
      "env": {
        "MEALIE_URL": "https://your-mealie.example.com",
        "MEALIE_API_TOKEN": "your-token"
      }
    }
  }
}

Related MCP server: Nextcloud Cookbook MCP Server

Quick start: Docker

MEALIE_URL=https://your-mealie.example.com docker compose up -d

Each client then sends its own Mealie API token as a Bearer token:

claude mcp add --transport http mealie http://localhost:3000 --header "Authorization: Bearer your-token"

Auth modes

Pick one. Over HTTP, the modes are exclusive.

See the login form guide before enabling it.

Tools

60 tools in seven groups: recipes, recipe-assets, ingredients, organizers, cookbooks, shopping, mealplans. Limit them with --preset minimal|default|full, --groups recipes,shopping or --read-only. The tool reference lists them all.

Documentation

• stdio

• Docker and API keys

• Login form

• Environment variables

• Tool filtering

• Contributing

Requires Mealie v3.29.0 or later (tested through v3.30.0) and Node.js 22.13 or newer.

License

MIT