Mealie MCP Server
MCP server for Mealie, the self-hosted recipe manager and meal planner
1 stars55 downloads/wk
Reviews
Write oneNobody has reviewed Mealie MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Mealie MCP Server tools (52, 26 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_recipe_commentAdds a comment to a recipe. Comments are visible to everyone in the
add_recipe_to_shopping_listAdds a recipe's ingredients to a shopping list, merging them with what
add_shopping_list_itemsAdds items to a shopping list as free text ("2 tbsp olive oil"). Mealie
create_cookbookwrite actionCreates a cookbook — a named, saved view of the recipe collection.
create_foodwrite actionAdds a food to the group vocabulary so ingredient lines can be matched
create_mealplan_entrywrite actionPuts a recipe or a free-text note on the meal plan for one day. Give
create_organizerwrite actionCreates a tag, category or recipe tool. Assigning one to a recipe with
create_random_mealwrite actionLets Mealie pick a recipe for a day and slot, honouring the meal plan
create_recipewrite actionCreates a recipe from the given fields. To add one from a website use
create_share_tokenwrite actionCreates a link that lets anyone read one recipe without logging in.
create_shopping_listwrite actionCreates an empty shopping list in the household.
create_timeline_eventwrite actionAdds an entry to a recipe's timeline — typically a note about having
create_unitwrite actionAdds a measurement unit to the group vocabulary.
delete_cookbookwrite actionDeletes a cookbook. The recipes it matched are not touched — a cookbook
delete_mealplan_entrywrite actionRemoves one entry from the meal plan. The recipe itself is not touched.
delete_organizerwrite actionDeletes a tag, category or tool. The recipes themselves are kept, but
delete_recipewrite actionDeletes a recipe permanently, together with its comments, timeline and
delete_recipe_commentwrite actionDeletes a comment. Requires confirmation: call once to receive a token,
delete_share_tokenwrite actionRevokes a share link, so the recipe is no longer readable through it.
delete_shopping_listwrite actionDeletes a shopping list and everything on it. Requires confirmation:
delete_shopping_list_itemswrite actionRemoves items from a shopping list for good. To merely tick something
duplicate_recipewrite actionCreates a copy of a recipe under a new name, leaving the original
get_aboutReports the Mealie version and the identity the API token acts as: user,
get_cookbookFetches a cookbook and the recipes it currently matches. Accepts the
get_recipeFetches one recipe with everything needed to cook it: ingredients,
get_shopping_listFetches one shopping list with all of its items, checked and unchecked.
get_todays_mealsReturns the recipes planned for today, as Mealie computes "today" for
import_recipe_from_html_or_jsonwrite actionCreates a recipe from HTML or schema.org recipe JSON supplied directly,
import_recipe_from_imagewrite actionCreates a recipe from a photo of one — a cookbook page, a handwritten
import_recipe_from_urlHas Mealie fetch a recipe page and save it as a new recipe. The fetch
list_cookbooksLists the cookbooks of the household. A cookbook is a saved filter over
list_foodsLists the structured foods of the group — the ingredient vocabulary
list_mealplansLists the meal plan of the household in a date range. Each entry is
list_organizersLists the tags, categories or tools defined in the group, with their
list_recipe_commentsLists the comments other users of the instance left on a recipe.
list_recipe_timelineLists the timeline of a recipe: when it was created, updated and each
list_share_tokensLists the public share links that currently exist, with the recipe each
list_shopping_listsLists the shopping lists of the household, without their items.
list_unitsLists the measurement units of the group, with their abbreviations.
parse_ingredientsSplits free-text ingredient lines into quantity, unit, food and note,
parse_recipe_ingredientsStructures a recipe's unparsed ingredient lines in place: Mealie's
preview_recipe_urlFetches a URL and reports what Mealie would extract from it, WITHOUT
remove_recipe_from_shopping_listwrite actionTakes a recipe's ingredients back off a shopping list. Items that were
search_recipesSearches the recipe collection. Returns summaries — name, slug, id,
set_recipe_imageReplaces a recipe's cover image.
set_recipe_last_madeRecords when a recipe was last cooked. Mealie shows this on the recipe
set_recipe_ratingSets the personal rating of a recipe and/or marks it as a favourite.
suggest_recipesSuggests recipes that can be cooked from the foods and tools marked as
update_mealplan_entrywrite actionMoves an entry to another day or slot, or replaces the recipe behind
update_organizerwrite actionRenames a tag, category or tool. Mealie regenerates the slug from the
update_recipewrite actionChanges individual fields of a recipe. Only the fields given are
update_shopping_list_itemswrite actionChanges items on a shopping list — most often ticking them off. Only
Public scan report
scanner v0.1.10 · 2026-10-15 · same rubric, same numbers if you re-run it
- Code scan51 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Mealie MCP Server compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 52
- the typical server has 7
- Tools that change things
- 50%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 55
- more than 46% of 12,191 servers with a package
What its tools let an agent do: 19 read · 16 create · 8 change · 9 delete
Release history: 4 versions in the registry since 2026-09-07, latest 2026-10-07, typically one every 8 days.
Install Mealie MCP Server in Claude Code, Cursor or VS Code
Runs npx -y @ni-c/mealie-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mealie-mcp -- npx -y @ni-c/mealie-mcp
What the publisher says
From the Mealie MCP Server repository's README, as published. We do not edit it. Read it on GitHub
mealie-mcp
<!-- badges: start -->
<!-- badges: end -->
A Model Context Protocol (MCP) server for Mealie, the self-hosted recipe manager and meal planner.
Lets MCP clients like Claude Code, Claude Desktop or Codex work with your recipe collection: search and read recipes with their ingredients and steps, import new ones from a website, keep tags and categories tidy, plan meals, build shopping lists from those plans, and record what was actually cooked.
Fifty-two tools is the ceiling, not the floor: MEALIEALLOWTOOLS=essential registers a curated eight instead, and a model picks the right tool far more reliably from eight than from fifty-two — see choosing which tools load.
<!-- is resolved against the colour scheme of the page showing it, so GitHub picks the variant that matches its own theme toggle. npm strips and when it sanitises the README and keeps the , which is why that fallback brings its own dark card instead of relying on a media query. -->
Mealie's REST API has 259 operations across 175 paths. This server exposes 52 tools, chosen so that the common tasks are one call and the dangerous surface is not reachable at all. Verified against Mealie v3.25.0; the source of truth for every request shape is the GET /openapi.json of a running instance, not the published documentation, which is out of date in several places.
What makes it different
Fifty-two curated tools out of 259 API operations. Mealie's REST API is far larger than a model should reach into; what is here covers the common tasks in one call — search, read and import recipes, keep tags and categories tidy, plan meals, build shopping lists, manage cookbooks and ratings.
updaterecipe uses PATCH, not PUT.** Mealie's replace route silently drops recipe fields that were not sent; only the fields you name change here.
The dangerous surface is unreachable. No admin routes, no token minting, no webhooks and no outbound-HTTP triggers, whatever the token would allow.
Requirements
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Mealie MCP Server: common questions
- Is Mealie MCP Server safe?
- Mostly: it is graded B (83/100). Read the Mealie MCP Server safety report
- How do I install Mealie MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Mealie MCP Server need an API key?
- Yes. The registry entry asks for
MEALIE_API_TOKEN. - Is Mealie MCP Server maintained?
- The last commit was 20 days ago (2026-10-15). The latest release is v0.6.0.
- How does Mealie MCP Server compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 52 (the typical server has 7); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.