Return public Mealie app/version information.

Check server reachability and whether authentication works.

Search Mealie recipes. Supports Mealie queryFilter syntax for advanced filters.

Fetch one recipe by slug or id.

Return Mealie recipe suggestions.

List household shopping lists.

List shopping list items, optionally filtered by shopping list and checked state.

List household meal plans. Dates are ISO yyyy-mm-dd strings.

Import/create a recipe from a public web URL after explicit confirmation.

Create a shopping list after explicit user confirmation.

Add an item to a shopping list after explicit user confirmation.

Fetch one household shopping list by id.

Fetch one household shopping list item by id.

Update a shopping item using Mealie v3's full-model PUT endpoint.

Delete one shopping list item after explicit confirmation.

Add a recipe's ingredients to a shopping list using Mealie v3.

Fetch today's household meal plan entries.

Create a household mealplan entry. Date must be ISO yyyy-mm-dd.

Update a mealplan entry using Mealie v3's full-model PUT endpoint.

Delete a mealplan entry after explicit confirmation.

Create a Mealie recipe from OCR/vision-extracted text and optional images.

Requires mutations enabled AND confirmed_by_user=True. Use this after showing the user a preview of title, ingredients, steps, tags, and asking for explicit confirmation. Ingredient lines are stored in display and note so Mealie mobile renders them correctly.

For cookbook/photo imports, the agent may choose a title-image crop itself: pass cover_crop_box=[left, top, right, bottom] with cover_crop_units="percent" (default, 0..100; fractional 0..1 is accepted too) or "pixels". The crop is taken from cover_crop_source_url, otherwise main_image_url, otherwise source_image_url, and uploaded as the Mealie recipe cover. The full source_image_url can still be uploaded as the original cookbook asset.

Upload or replace the cover image of an existing Mealie recipe.

The image is read from an HTTP(S) URL, file:// URL, or local path and sent to Mealie as a real multipart file upload. It is never stored as an external URL in the recipe object. Requires mutations enabled and an explicit user confirmation. An optional crop uses [left, top, right, bottom] in percent (default), fraction, or pixels.

Upload a real file asset to an existing recipe via multipart.

Delete an existing recipe cover image after explicit confirmation.

Duplicate a recipe, optionally assigning a new name.

Set a recipe's last-made timestamp using an ISO 8601 date-time.

List tags, categories, foods, units, cookbooks, comments, or timeline events.

Search the live Mealie OpenAPI operation catalog.

Returns operation IDs, methods, paths, tags, parameters, and content types. Admin/auth/user/backup/maintenance operations are hidden by default and are documentation-only even when include_sensitive=True.

Execute a non-sensitive JSON Mealie operation by OpenAPI operation ID.

Use mealie_api_operations first. Mutations require explicit confirmation and remain restricted by MEALIE_MCP_MUTATION_SCOPE. Multipart/binary operations require a dedicated MCP tool.

Execute a non-sensitive multipart Mealie operation by OpenAPI operation ID.

file_sources maps multipart field names to direct HTTP(S)/file URLs or local paths. Mutations require explicit confirmation and an enabled scope.

Download a non-sensitive binary GET operation to a controlled local directory.

Generic authenticated GET validated against live OpenAPI and security tags.

Generic JSON Mealie API request for non-sensitive paths.

Non-GET methods require explicit user confirmation and an enabled mutation scope. Prefer mealie_api_operation_request because it validates against the live OpenAPI document.

OCR: Extrahiere Rohtext aus einem Kochbuchfoto/Screenshot.

Lädt das Bild von einer URL oder lokalem Pfad, bereitet es für OCR auf (Graustufen, Kontrast, Binarisierung) und gibt den erkannten Text zurück.

Der Rohtext kann dann per Text-LLM in Zutaten/Anweisungen strukturiert und mit mealie_create_recipe_from_text importiert werden.

Das spart teure Vision-API-Aufrufe.

Suche Rezepte auf Chefkoch.de.

Durchsucht Chefkoch.de nach Rezepten passend zur Suchanfrage und gibt eine Liste mit Grundinformationen zurueck (Titel, URL, Beschreibung, Bild, Kategorie, Zubereitungszeit, Bewertung).

Verwendung: Vor einem Mealie-Import die Rezeptsuche, um das passende Rezept zu finden. Der Benutzer kann dann per URL oder per mealie_get_chefkoch_recipe die vollstaendigen Details abrufen.

Rufe ein vollstaendiges Chefkoch-Rezept mit allen Details ab.

Liefert Zutaten-Liste, Schritt-fuer-Schritt-Anleitung, Zubereitungszeit, Kategorie, Bewertung und Naehrwerte (falls vorhanden) fuer ein Rezept.

Der Bot nutzt diese Daten, um das Rezept strukturiert anzuzeigen oder in Mealie zu importieren.

Parse ingredient lines via Mealie's ingredient parser.

Accepts a list of raw ingredient strings (e.g. '650 g Süßkartoffeln, in etwa 4 cm große Würfel geschnitten') and returns structured results with quantity, unit, food, and note fields.

The parsed results can be passed directly to mealie_update_recipe_ingredients for updating existing recipes.

Replace the ingredient list of an existing Mealie recipe with structured data.

Each ingredient dict must contain at least 'quantity', 'unit', 'food', and optionally 'note' and 'display'. Supports both structured inputs (as returned by mealie_parse_ingredients) and raw strings (which get stored in the display/note format for backward compatibility).

The tool fetches the current recipe, replaces its ingredient list, applies any additional update_fields, and patches it back via the Mealie API.

Typical structured ingredient format: {"quantity": 650, "unit": {"name": "g"}, "food": {"name": "Süßkartoffeln"}, "note": "in etwa 4 cm große Würfel geschnitten"}

Raw string fallback: "650 g Süßkartoffeln, in etwa 4 cm große Würfel geschnitten"

Returns the updated recipe slug and ingredient count.