Add a recipe's ingredients to a shopping list. scale multiplies amounts.

Create a category.

Create a cookbook. query_filter_string is the Mealie filter DSL.

Create a food (ingredient).

Create a label. color is a CSS hex string like '#3f51b5'.

Create a meal-plan entry.

Supply either recipe_id (UUID) for a recipe entry, or title/text for a freeform entry. entry_type is one of: breakfast, lunch, dinner, side.

Create a meal-plan rule.

day is monday..sunday or "unset" (any day). entry_type is breakfast/lunch/dinner/side. query_filter_string is the Mealie filter DSL (e.g. tags.name = "quick").

Create an empty recipe by name. Returns the new slug.

Scrape a recipe from a URL using Mealie's scraper. Returns the new slug.

Create a single shopping item on a list.

Free-form items: pass note (e.g. "carrots, 2 lb"). Structured items: set is_food=true and pass food_id, optional unit_id.

Bulk-create shopping items from a JSON array.

items_json is a JSON array of item objects. Each item must include shoppingListId (UUID); note and quantity are typical optional fields.

Create a shopping list with the given name.

Create a tag.

Create a kitchen tool.

Create a unit of measure. fraction/use_abbreviation: 0=false, 1=true.

Delete a category by UUID.

Delete a cookbook by UUID.

Delete a food by UUID.

Delete a label by UUID.

Delete a meal-plan entry by id.

Delete a meal-plan rule by UUID.

Delete a recipe by slug. This is permanent.

Delete a shopping item by UUID.

Delete a shopping list by UUID.

Delete a tag by UUID.

Delete a kitchen tool by UUID.

Delete a unit by UUID.

Return Mealie server version and basic info. Confirms connectivity.

Fetch a category by UUID.

Fetch a cookbook by UUID.

Fetch a food by UUID.

Fetch a label by UUID.

Fetch a meal-plan entry by numeric id.

Fetch a meal-plan rule by UUID.

Fetch a full recipe by slug, including ingredients and instructions.

Return the installed version of the mcp-mealie server.

Fetch a shopping item by UUID.

Fetch a shopping list by UUID, including its items.

Fetch a tag by UUID.

Fetch a kitchen tool by UUID.

Fetch a unit by UUID.

List recipe categories.

List cookbooks (saved recipe filters) for the current household.

List ingredient foods.

List multi-purpose labels (used by foods, shopping items, etc.).

List meal-plan rules used by the random-meal generator.

List meal-plan entries, optionally bounded by start_date/end_date.

List recipes with optional search, sorting, and pagination.

List shopping items, optionally filtered to one shopping list.

List shopping lists for the current household.

List recipe tags.

List kitchen tools.

List units of measure.

Parse a single ingredient string into structured quantity/unit/food.

parser is "nlp" (default, CRF model) or "brute" (regex fallback).

Parse many ingredient strings. ingredients_json is a JSON string array.

Re-parse a recipe's free-text ingredients and bind to food/unit IDs.

Reads the recipe's current ingredients, runs each line through Mealie's NLP parser, looks up matching food / unit records (matching on name, plural, abbreviations, and aliases — case-insensitive), creates new food / unit records when no match exists, and writes the bound result back to the recipe. After this runs, ingredients are eligible for shopping-list aggregation.

Lines whose parsed average confidence falls below min_confidence are stored as free text (no binding) so quirky lines like "splash of sake for deglazing" don't pollute the food catalogue.

Returns a per-line summary of what was bound vs. left as free text.

Remove a recipe's ingredients from a shopping list.

Replace a recipe's ingredient list with the given lines.

ingredients_json is a JSON array of strings, one per ingredient (e.g. ["1 cup flour", "2 eggs"]). Each string is stored verbatim; the user can re-parse to structured quantity/unit/food in the Mealie UI afterward to enable shopping-list integration.

Like set_recipe_ingredients, but parses each line and binds food/unit IDs.

ingredients_json is a JSON array of strings. Each is run through Mealie's NLP parser; recognized food / unit names are matched against the existing taxonomy (or created if not present), so the resulting recipe is shopping-list-aggregation-ready.

Lines whose parsed average confidence falls below min_confidence are stored as free text.

Returns a per-line summary of what was bound vs. left as free text.

Replace a recipe's instruction steps with the given lines.

instructions_json is a JSON array. Each element is either:

• a string ("Boil water: bring 4 quarts to a rolling boil"), or

• an object ({"title": "Prep", "summary": "Boil water", "text": "..."})

Strings starting with a short "Header: rest" prefix are auto-split: the header goes into the step's summary (rendered as a per-step header in Mealie's UI), and the rest goes into text. The title field is reserved for section dividers between groups of steps and is only set when the dict form provides one.

Replace a recipe's notes with the given JSON array.

notes_json is a JSON array of {title, text} objects. title is optional; text is required. Example: [{"title": "Tip", "text": "Toast the spices first."}].

Set the calling user's rating and/or favorite flag for a recipe.

rating: 0-5 (decimals allowed). Pass -1 to leave unchanged. is_favorite: 0=remove, 1=add. Pass -1 to leave unchanged.

Rename a category by UUID.

Patch a cookbook. Use public=1 to make public, public=0 to unpublish.

Patch a food.

Patch a label.

Patch a meal-plan entry. Only non-empty fields are sent.

Patch a meal-plan rule.

Patch a recipe. Only non-empty fields are sent.

Note: rating is per-user in Mealie 2.x+ and is not exposed here. Set it via the Mealie UI (or a future dedicated tool) against POST /api/users/{user_id}/ratings/{slug}.

Patch a shopping item. checked: 0=unchecked, 1=checked, -1=leave.

Patch a shopping list. Currently supports renaming.

Rename a tag by UUID.

Rename a kitchen tool by UUID.

Patch a unit.

Return the user owning the configured API token. Confirms auth works.