Skip to content

Getting Started ​

mealie-mcp is an MCP (Model Context Protocol) server that connects any MCP-compatible AI assistant to your Mealie instance.

Prerequisites ​

  • A running Mealie instance, v3.29.0 or later
  • An MCP-compatible AI client (Claude Code, Claude Desktop, or other)
  • Node.js 22.13+ (for npm setups) or Docker (for the container setup)

Choose your setup ​

MethodTransportBest for
npm — stdiostdioSimplest setup, AI on the same machine
Docker and API keysHTTP + Mealie API tokenShared server, each client sends its own key
Login formHTTP + OAuth 2.0Shared server, people log in with their Mealie account
Git checkoutstdio or HTTPContributing or local development

Nightly builds ​

Want to test unreleased changes from develop? Install a nightly build via the @nightly (npm) or :nightly (Docker) tag. A normal install always gives you the latest tagged release.

How it works ​

The server exposes Mealie's REST API as MCP tools, and your AI assistant calls them when you ask about recipes, shopping or meal plans.

With 60 tools across 7 groups, you can optionally load only a subset to save context window space. See Tool filtering.

Released under the MIT License.