mealie-mcp-server
MCP server for Mealie recipe management
Versions
1.4.0latest1.3.01.2.11.2.01.1.1+ show 4 moreshow less
1.1.01.0.21.0.10.0.1Tools 63
get_shopping_lists Lists the household\
create_shopping_list Creates a new shopping list.
get_shopping_list Retrieves a shopping list by its UUID.
update_shopping_list Updates a shopping list\
delete_shopping_list Deletes a shopping list.
add_recipe_to_shopping_list Adds a recipe\
remove_recipe_from_shopping_list Removes a recipe\
get_shopping_list_items Lists all shopping list items across lists with pagination.
create_shopping_list_item Creates a single shopping list item.
create_shopping_list_items_bulk Creates multiple shopping list items at once.
update_shopping_list_item Updates a shopping list item\
delete_shopping_list_item Deletes a single shopping list item.
delete_shopping_list_items_bulk Deletes multiple shopping list items at once.
get_tags Lists and searches the household\
get_empty_tags Returns tags that have no recipes assigned.
create_tag Creates a new recipe tag.
get_tag Retrieves a single tag by its UUID.
get_tag_by_slug Retrieves a single tag by its URL slug.
update_tag Updates a tag\
delete_tag Deletes a tag. Mealie may refuse if recipes still reference it.
get_categories Lists and searches the household\
get_empty_categories Returns categories that have no recipes assigned.
create_category Creates a new recipe category.
get_category Retrieves a single category by its UUID.
get_category_by_slug Retrieves a single category by its URL slug.
update_category Updates a category\
delete_category Deletes a category. Mealie may refuse if recipes still reference it.
get_units Search or list canonical Mealie ingredient units (e.g.
get_unit Retrieves a single canonical Mealie ingredient unit by ID, including its aliases, abbreviations, and
get_unit_matches Finds existing canonical Mealie unit candidates for multiple already-interpreted unit concepts in one
create_unit Creates a canonical Mealie ingredient unit when an appropriate unit does not already exist. Call
update_unit Updates an existing canonical Mealie ingredient unit. Fields left unspecified keep their current value.
delete_unit DESTRUCTIVE and irreversible: permanently deletes a canonical Mealie ingredient unit. Use get_unit first
get_foods Lists and searches the household\
get_food Retrieves a single food by ID, including its aliases and label information when present.
get_food_matches Finds existing canonical Mealie food candidates for multiple already-interpreted food concepts in one
create_food Creates a new food. Call get_foods first to check whether an existing food or alias already covers this
update_food Updates an existing food. Fields left unspecified keep their current value. Sufficient for adding an alias:
delete_food DESTRUCTIVE and irreversible: permanently deletes a food. Use get_food first to verify this is the exact
get_all_mealplans Lists meal plans with optional date range filtering and pagination.
get_mealplan_with_recipes Returns meal plans with embedded recipe details (full recipe data fetched via batch requests with bounded concurrency).
create_mealplan Creates a single meal plan entry for a given date.
create_mealplan_bulk Creates multiple meal plan entries at once via concurrent requests.
get_todays_mealplan Returns today\
patch_mealplan Performs a batch of mixed operations on meal plan entries in a single call. Use this to move recipes between meal types, update entries, or add new ones.
get_recipes Searches and lists recipes with pagination. Categories and tags are resolved by name/slug/ID against
find_recipes_for_ingredients Finds recipes that contain one or more requested ingredients. Ingredient names are resolved against
get_recipe_detailed Retrieves a recipe by slug with full details including nutrition, settings, and assets.
get_recipe_concise Retrieves a recipe by slug, filtered to summary fields (name, slug, servings, yield, total time, rating, ingredients, last made).
get_recipes_batch Fetches multiple recipes by slug with bounded concurrency (4 in-flight requests at a time).
get_recipes_detailed_batch Fetches multiple recipes by slug with full details (including nutrition) and bounded concurrency.
get_recipes_for_classification Compact, paginated, READ-ONLY feed of recipes for assigning Categories and Tags. Returns only the
get_recipes_for_ingredient_parsing Compact, paginated, READ-ONLY work queue of recipes whose ingredients may need structured parsing. This
create_recipe Creates a new recipe. Optionally sets ingredients and instructions on creation.
patch_recipe Partially updates a recipe. Also accepts optional categories/tags/taxonomyMode/createMissing for taxonomy assignment.
update_recipe_ingredients Replaces the complete structured ingredient collection (recipeIngredient) of an existing recipe, leaving
update_recipe_ingredients_batch Runs update_recipe_ingredients for multiple recipes with bounded concurrency (5 at a time). Use this
update_recipe_taxonomy Updates a recipe\
update_recipe_taxonomy_batch Runs update_recipe_taxonomy for multiple recipes with bounded concurrency (5 at a time), returning a
duplicate_recipe Creates a duplicate of an existing recipe with an optional new name.
mark_recipe_last_made Records the current timestamp as the recipe\
set_recipe_image_from_url Sets a recipe\
delete_recipe Permanently deletes a recipe.
Permissions 3
network medium filesystem low env_vars low