Which integrations are available for this server?

Provides integration with Mealie's API, enabling recipe search and retrieval, recipe creation and import from URLs or plain text, meal planning, and shopping list management.

How do I use mealie-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mealie-mcp search my recipes for chicken and add one to tonight's dinner plan" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mealie-mcp

by kanylbullen

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

mealie-mcp

An MCP server for Mealie: search and read recipes, import them from URLs or plain text, plan meals, and manage shopping lists — from claude.ai, Claude Desktop, Claude Code or any other MCP client.

Runs as a single long-lived Streamable HTTP server with OAuth 2.1 in front (any OIDC IdP; built and tested against Authentik), or over stdio for local use.

Tools (16)

Area	Tools
Recipes	`search_recipes`, `get_recipe`, `create_recipe_from_url`, `create_recipe`, `update_recipe`
Meal plan	`get_mealplan`, `add_mealplan_entry`, `update_mealplan_entry`, `remove_mealplan_entry`, `add_random_mealplan_entry`
Shopping	`list_shopping_lists`, `get_shopping_list`, `add_recipe_to_shopping_list`, `add_shopping_items`, `check_shopping_items`
Organizers	`list_categories_and_tags`

Deliberately not included: deleting recipes, bulk imports, anything under /api/admin, backups, user management. Deleting is a rare, deliberate act that belongs in the web UI.

Two scopes: mealie:read and mealie:write (write implies read). Scopes are checked inside every tool function, not just declared in metadata.

Related MCP server: Mealie MCP Server

How it fits together

MCP client ──OAuth 2.1──► mealie-mcp ──Mealie API token──► Mealie
   │ login + consent           │
   ▼                           │ RFC 9728 metadata, WWW-Authenticate challenge,
 your IdP (Authentik, …)       │ optional RFC 7591 DCR front (OAuthProxy)

Two auth boundaries. OAuth gates client → server. The server → Mealie hop always uses one Mealie API token, ideally for a dedicated, non-admin Mealie user — everything the server does shows up in Mealie as that user. scripts/setup_mealie_user.py creates that user and token without ever printing them.

Quick start (stdio, local)

pip install .
export MEALIE_URL=http://127.0.0.1:9000 MEALIE_TOKEN=<api token>
mealie-mcp            # speaks MCP over stdio

Remote with OAuth

See docs/DEPLOY.md. In short:

MCP_TRANSPORT=http MCP_HTTP_HOST=127.0.0.1 MCP_HTTP_PORT=3011
MCP_PUBLIC_URL=https://mealie-mcp.example.com
MCP_AUTH_MODE=oauth-proxy
MCP_OAUTH_ISSUER=https://auth.example.com/application/o/mealie-mcp/
MCP_OAUTH_AUDIENCE=https://mealie-mcp.example.com/mcp
MCP_OAUTH_CLIENT_ID=… MCP_OAUTH_CLIENT_SECRET=…
MEALIE_URL=http://127.0.0.1:9000 MEALIE_TOKEN=…

The HTTP transport refuses to start without OAuth unless you set MCP_ALLOW_UNAUTHENTICATED_HTTP=1 for loopback testing.

Configuration

Variable	Meaning
`MEALIE_URL` / `MEALIE_TOKEN`	Mealie base URL and API token (required)
`MEALIE_PUBLIC_URL`	URL for links in results, if different from `MEALIE_URL`
`MEALIE_INGREDIENT_PARSER`	`auto` (default: `openai` if Mealie has it, else `nlp`), `nlp`, `openai`, `brute`
`MCP_TRANSPORT`	`stdio` (default) or `http`
`MCP_HTTP_HOST` / `MCP_HTTP_PORT` / `MCP_HTTP_PATH`	bind address (default `127.0.0.1:8000/mcp`)
`MCP_PUBLIC_URL`	externally reachable base URL (required for OAuth)
`MCP_AUTH_MODE`	`none`, `oauth` (resource server only), `oauth-proxy` (adds DCR front)
`MCP_OAUTH_ISSUER` / `MCP_OAUTH_AUDIENCE` / `MCP_OAUTH_JWKS_URI`	token verification
`MCP_OAUTH_CLIENT_ID` / `MCP_OAUTH_CLIENT_SECRET`	this server's client at the IdP (proxy mode)
`MCP_OAUTH_CLIENT_REDIRECT_URIS`	allow-list for MCP clients' redirect URIs (default: claude.ai/claude.com callbacks + localhost)
`MCP_RATELIMIT_PER_MINUTE` / `MCP_TRUST_FORWARDED_FOR`	per-IP limit on `/register`, `/token`, `/authorize`
`FASTMCP_HOME`	where the OAuth proxy persists client registrations — must survive restarts

Development

python -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/pytest

License

MIT. The auth and rate-limit modules are adapted from molnkontakt/odoo-mcp by the same author.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

recipes A
io.github.pipeworx-io
Recipes MCP — wraps TheMealDB API (free tier, no auth)
Search Open Data
2
bakeryosOAuth
io.github.jessedu29260-netizen
BakeryOS bakery-management MCP — recipes, costs, production; propose changes via OAuth.
ERP Systems
2
Coach WattsOAuth
com.coachwatts
Remote MCP server for training, nutrition, wellness, and performance data with OAuth 2.0.
Health & Wellness Fitness Tracking
271
ToolforestOAuth
io.toolforest
Hosted MCP server with managed OAuth for 15+ toolkits: Google Workspace, Fitbit, Oura, Kalshi, etc.
Workplace & Productivity Health & Wellness Finance
2

Related MCP Servers

Mealie MCP Server
Databases Developer Tools App Automation
rldiao
A
license
Not graded
quality
B
maintenance
Enables AI assistants to interact with Mealie recipe databases through MCP clients like Claude Desktop.
Updated a month ago (2026-08-27 10:25 UTC)
141
MIT
Mealie MCP Server
App Automation Content Management Systems
nikopol666
A
license
Not graded
quality
B
maintenance
Enables interaction with Mealie for managing recipes, meal plans, shopping lists, foods, units, tags, categories, and more through MCP.
Updated 2 months ago (2026-07-09 19:08 UTC)
MIT
Mealie MCP Server
Content Management Systems Search Web Scraping
rorymcdaniel
A
license
Not graded
quality
C
maintenance
Connects MCP clients like Claude to your Mealie recipe manager, enabling natural language search, creation, import, and updates of recipes.
Updated 6 months ago (2026-03-26 17:02 UTC)
92 npm
MIT
mealie-mcp
Search
dvejsada
A
license
Not graded
quality
B
maintenance
A read-only MCP server for Mealie that enables searching recipes, managing shopping lists, meal plans, and retrieving household/instance info via tools. Supports secure per-user authentication and multiple Mealie instances.
Updated 3 days ago (2026-09-20 01:12 UTC)
MIT