List all recipes in Mealie. Returns recipe summaries with name, slug, description, and metadata.

Get a recipe by its slug. Returns full recipe details including ingredients and instructions.

Create a new recipe with name, ingredients, and instructions. For ingredients, prefer passing originalText (e.g. "2 cups flour") and let the server parse — the structured {quantity, unit, food} form also works but originalText is simpler and handles unknown units/foods automatically.

Update an existing recipe by slug. Only provided fields will be updated. For ingredients, prefer passing originalText (e.g. "2 cups flour") over structured {quantity, unit, food} — the server parses originalText and auto-resolves unit+food. Structured form also works and is auto-normalized, but originalText is simpler.

Delete a recipe by its slug. This action cannot be undone.

Upload an image for a recipe. Provide the image as base64-encoded data.

List all foods/ingredients in Mealie. Can be filtered by search term.

Create a new food/ingredient in Mealie.

List all shopping lists in Mealie.

Get a shopping list by ID. Returns the list with all items.

Add an item to a shopping list. Can specify quantity, unit, food, or just a note.

Update a shopping list item. Can modify quantity, note, or checked status (to mark items as purchased).

Remove an item from a shopping list.

Add all ingredients from a recipe to a shopping list. Optionally specify quantity for multiple servings.

List all recipe categories in Mealie. Categories help organize recipes into groups like "Dinner", "Breakfast", "Italian", etc.

Create a new recipe category in Mealie. Categories help organize recipes into logical groups.

List all recipe tags in Mealie. Tags provide flexible labeling for recipes like "vegetarian", "gluten-free", "kid-friendly", etc.

Create a new recipe tag in Mealie. Tags provide flexible labeling for recipes.

Test if a URL can be scraped for recipe data without actually creating a recipe. Useful for validating URLs before importing. Returns success:false when the scraper cannot parse the site.

Create a new recipe by scraping data from a URL. Supports most recipe websites that use structured data (schema.org Recipe format). On failure, returns success:false with diagnostic info — check that before retrying or falling back to create_recipe.

Create a recipe from raw HTML that you fetched yourself. Use this when create_recipe_from_url fails because the MCP server can't reach the site (anti-bot, geo-block, etc.). Fetch the HTML with your own browser tool and pass it here — the server parses it via Mealie or by extracting schema.org JSON-LD directly.

List meal plan entries within a date range. If no dates provided, returns all meal plans.

Get today's meal plan entries. Returns all meals planned for the current day.

Create a new meal plan entry for a specific date. Can optionally link to an existing recipe.

Delete a meal plan entry by its ID.

Get information about the current API user, including their group and household. Useful for debugging permission issues when recipes or other items are not visible.

Re-parse all ingredients for an existing recipe so each has proper quantity, unit, and food fields instead of free-text notes. Fetches the recipe, sends each ingredient note through the Mealie ingredient parser, creates any missing unit/food records, and saves the structured ingredients back to the recipe. Use this after importing a recipe from a URL whose ingredients came in as plain text.