Search recipes by keyword with optional category/tag filters.

Args: query: Search text (name, description, ingredients) page: Page number (default 1) per_page: Results per page (default 10) categories: Filter by category slugs tags: Filter by tag slugs

Get full recipe details including ingredients, instructions, and nutrition.

Args: slug: Recipe slug identifier (from search results)

Get just the ingredient list for a recipe.

Args: slug: Recipe slug identifier

Import a recipe by scraping a URL. Mealie will extract the recipe data automatically.

Args: url: URL of the recipe page to import

Create a new recipe manually.

Args: name: Recipe name description: Short description recipe_yield: Yield description (e.g. "15–18 rolls", "1 loaf") servings: Numeric serving count that enables scaling (e.g. 6, 8, 15) total_time: Total time (e.g. "45 minutes") prep_time: Prep time perform_time: Cook time ingredients: List of ingredient dicts, each with optional keys: - section (str): creates a visual section header (no other fields used) - quantity (float): numeric amount (e.g. 300, 2.5) - unit (str): unit name or abbreviation (e.g. "g", "cup", "tbsp") - food (str): ingredient name (e.g. "bread flour", "butter") - comment (str): extra info shown alongside (e.g. "softened", "about 1¾ tsp") instructions: List of instruction steps — each may be a plain string or a dict with: - text (str): step body - title (str, optional): step heading shown in UI - summary (str, optional): one-line takeaway for cook mode - ingredient_refs (list[str], optional): UUIDs of linked ingredients categories: Category names to assign tags: Tag names to assign notes: List of note dicts, each with: - title (str): section label (e.g. "Non-Negotiables") - text (str): note body extras: Arbitrary JSON metadata (e.g. {"isFoundation": true})

Update fields on an existing recipe. Only provided fields are changed.

Args: slug: Recipe slug to update name: New recipe name description: New description recipe_yield: Yield description (e.g. "15–18 rolls", "1 loaf") servings: Numeric serving count that enables scaling (e.g. 6, 8, 15) total_time: New total time prep_time: New prep time perform_time: New cook time ingredients: Replace ingredient list. Each dict has optional keys: - section (str): creates a visual section header (no other fields used) - quantity (float): numeric amount (e.g. 300, 2.5) - unit (str): unit name or abbreviation (e.g. "g", "cup", "tbsp") - food (str): ingredient name (e.g. "bread flour", "butter") - comment (str): extra info shown alongside (e.g. "softened", "about 1¾ tsp") instructions: Replace instruction steps — each may be a plain string or a dict with: - text (str): step body - title (str, optional): step heading shown in UI - summary (str, optional): one-line takeaway for cook mode - ingredient_refs (list[str], optional): UUIDs of linked ingredients categories: Replace categories tags: Replace tags notes: Replace note blocks. Each dict has: - title (str): section label (e.g. "Non-Negotiables") - text (str): note body extras: Replace arbitrary JSON metadata (e.g. {"isFoundation": true})

Delete a recipe permanently.

Args: slug: Recipe slug to delete

List all shopping lists.

Get a shopping list with all its items.

Args: list_id: Shopping list ID (from get_shopping_lists)

Create a new empty shopping list.

Args: name: Name for the new list

Delete a shopping list.

Args: list_id: Shopping list ID to delete

Add an item to a shopping list.

Args: list_id: Shopping list ID note: Item description (e.g. "2 lbs chicken breast") quantity: Numeric quantity (optional, for structured items) unit_id: Unit ID from get_units (optional) food_id: Food ID from search_foods (optional)

Remove an item from a shopping list.

Args: list_id: Shopping list ID (for context) item_id: Item ID to remove (from get_shopping_list)

Check or uncheck a shopping list item.

Args: list_id: Shopping list ID item_id: Item ID to check/uncheck checked: True to check, False to uncheck (default True)

Add all ingredients from a recipe to a shopping list.

Args: list_id: Shopping list ID recipe_slug: Recipe slug to add ingredients from

Get meal plan entries for a date range.

Args: start_date: Start date (YYYY-MM-DD) end_date: End date (YYYY-MM-DD)

Add a meal plan entry for a specific date.

Args: date: Date for the entry (YYYY-MM-DD) entry_type: Meal type — "breakfast", "lunch", "dinner", or "side" recipe_slug: Recipe slug to plan (use this OR title/note) title: Free-text title (for non-recipe entries) note: Additional note text

Remove a meal plan entry.

Args: entry_id: Meal plan entry ID (from get_meal_plans)

Auto-fill a date range with random recipes from your collection.

Args: start_date: Start date (YYYY-MM-DD) end_date: End date (YYYY-MM-DD) entry_type: Meal type — "breakfast", "lunch", "dinner", or "side" (default "dinner")

List all recipe categories.

List all recipe tags.

List all cookbooks.

Get recipes in a cookbook.

Args: cookbook_slug: Cookbook slug identifier page: Page number (default 1) per_page: Results per page (default 10)

Create a new recipe category.

Args: name: Category name

Create a new recipe tag.

Args: name: Tag name

Search the foods database.

Args: query: Search text page: Page number (default 1) per_page: Results per page (default 10)

List all measurement units available in Mealie.