Return the installed version of the mcp-mealie server.

Return Mealie server version and basic info. Confirms connectivity.

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

List recipes with optional search, sorting, and pagination.

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

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

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

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}.

Delete a recipe by slug. This is permanent.

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.

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.

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."}].

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.

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.

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

Fetch a cookbook by UUID.

Create a cookbook. query_filter_string is the Mealie filter DSL.

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

Delete a cookbook by UUID.

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

Fetch a meal-plan entry by numeric id.

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.

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

Delete a meal-plan entry by id.

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

Fetch a meal-plan rule by UUID.

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").

Patch a meal-plan rule.

Delete a meal-plan rule by UUID.

List shopping lists for the current household.

Fetch a shopping list by UUID, including its items.

Create a shopping list with the given name.

Patch a shopping list. Currently supports renaming.

Delete a shopping list by UUID.

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

Remove a recipe's ingredients from a shopping list.

List shopping items, optionally filtered to one shopping list.

Fetch a shopping item by UUID.

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.

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

Delete a shopping item by UUID.

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.

List recipe categories.

Fetch a category by UUID.

Create a category.

Rename a category by UUID.

Delete a category by UUID.

List recipe tags.

Fetch a tag by UUID.

Create a tag.

Rename a tag by UUID.

Delete a tag by UUID.

List kitchen tools.

Fetch a kitchen tool by UUID.

Create a kitchen tool.

Rename a kitchen tool by UUID.

Delete a kitchen tool by UUID.

List ingredient foods.

Fetch a food by UUID.

Create a food (ingredient).

Patch a food.

Delete a food by UUID.

List units of measure.

Fetch a unit by UUID.

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

Patch a unit.

Delete a unit by UUID.

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

Fetch a label by UUID.

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

Patch a label.

Delete a label by UUID.