Labsco
MCP SERVER

Mealie

by rldiao

Run your Mealie recipe box by talking to it — search recipes, build the shopping list from a recipe's ingredients, and fill in the week's meal plan.

Food, Dining & Delivery
Summary
The gap between a recipe and a shopping list closes in one call.

add_recipe_to_shopping_list is the tool that earns this server its place — it turns 'I'm making the lasagna this week' into a list without you copying ingredients across. The bulk item tools mean the everyday cleanup, checking off what you bought and clearing the rest, happens in a single request rather than a dozen.

What it is

A server covering the Mealie self-hosted recipe manager's API as 62 tools, grouped into recipes, shopping lists, categories, tags, units, recipe tools, and meal plans.

What you get
  • Recipes handled end to end: get_recipes searches with text, category, tag and tool filters joined by AND/OR logic, get_recipe_detailed and get_recipe_concise read one back, and create_recipe, create_recipe_full, update_recipe, patch_recipe, duplicate_recipe and delete_recipe cover the writes
  • Images and files attached — set_recipe_image_from_url scrapes an image from a page, upload_recipe_image_file and upload_recipe_asset_file take a file from disk, and mark_recipe_last_made stamps when you actually cooked it
  • Shopping lists as a full surface: create, read and delete lists; add, update, check off and remove items one at a time or in bulk with the _bulk tools
  • add_recipe_to_shopping_list pulls a recipe's ingredients straight onto a list, and remove_recipe_from_shopping_list takes them back off
  • Categories and tags created, listed and filtered, with tools to find the ones that have no recipes attached so you can clean them up
  • Units and recipe tools each get their own small CRUD set, including get_tool_by_slug
  • Meal plans read and written — get_all_mealplans, create_mealplan, create_mealplan_bulk to lay in several at once, and get_todays_mealplan for what is on today
Requirements

A running Mealie instance and an API key from it, given as MEALIE_BASE_URL and MEALIE_API_KEY. Python 3.12+ and the uv package manager; run it with uvx git+https://github.com/rldiao/mealie-mcp-server, or install it with the fastmcp command against src/server.py.

Setup effort

One command plus a key — uvx git+https://github.com/rldiao/mealie-mcp-server, then supply credentials