The Better Mealie MCP server exposes Mealie's full API (259 tools) as MCP tools, allowing AI assistants to manage every aspect of a Mealie instance through natural language.
Recipes: Import from URLs, search by ingredients, create/update/delete recipes, manage tags, categories, ratings, favorites, comments, assets, and perform bulk operations.
Meal Planning: Create, update, and delete meal plan entries, get today's meals, generate random meal suggestions based on rules, and manage mealplan rules.
Shopping Lists: Full CRUD for shopping lists, add/remove recipe ingredients, update item quantities/checked status, manage label settings, and perform bulk operations on items.
Household Management: View household info, members, preferences, and statistics; manage permissions and invitations; configure event notifications (Apprise-based) and scheduled webhooks; create and trigger custom recipe actions.
Cookbooks: Create, update, delete, and reorder household cookbooks.
User & Authentication: Register users, log in/out, refresh tokens, manage API tokens, update profiles (images, passwords), and manage recipe ratings and favorites.
Group Management: View group info and members, list group households, and configure AI provider integrations (model, API key, base URL, headers) and their default settings.
Application Info: Retrieve app about information, startup details, and theme settings.
Provides tools for interacting with Mealie's API, enabling AI agents to manage recipes, meal plans, shopping lists, households, and more from any AI assistant in natural language.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Better Mealie MCP Plan my dinners for next week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server exposing every Mealie API endpoint — all 250+ operations, none excluded. Manage recipes, meal plans, shopping lists, households and more from any AI assistant, in natural language.
Built with FastMCP from_openapi: tools are
generated straight from Mealie's OpenAPI spec, so the server stays in sync with
Mealie and nothing is hand-maintained. See TOOLS.md for the full
tool list.
You say | What happens |
"Add a chicken tikka masala recipe from this URL" | Scrapes and imports the recipe |
"What can I cook with what's in my pantry?" | Searches recipes by your ingredients |
"Plan my dinners for next week" | Creates meal-plan entries |
"Build a shopping list for those meals" | Generates a consolidated shopping list |
"Tag all my soups as 'winter'" | Bulk-updates recipe tags |
Related MCP server: Mealie MCP Server
Don't hand-write JSON. The wizard walks you through every choice and emits a ready-to-paste config for your combination:
Install — Docker image or from source.
Client — Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI, or ChatGPT (it knows each one's config shape).
Connection — stdio or HTTP, API token or username/password.
Limit tools (optional) — trim the 259 tools to just the groups you need,
for leaner context or clients that cap tool counts. Start from a pack
(Cooking, Meal planning, Sharing & browse, Admin & users) or pick
groups individually; tap a group's ⓘ to see every tool inside it. Your choice
is baked into the generated config as MEALIE_INCLUDE_TAGS.
Docker (GHCR image):
docker pull ghcr.io/djwmarcx/better-mealie-mcp
docker run -i --rm \
-e MEALIE_BASE_URL=http://host.docker.internal:9925 \
-e MEALIE_API_TOKEN=... \
ghcr.io/djwmarcx/better-mealie-mcp # stdio; add `--http 8000` for HTTPImages are published on each release, tagged <mealie-version> and latest.
Inside a container, localhost is the container — point MEALIE_BASE_URL at
host.docker.internal (macOS/Windows) or your host's LAN IP (Linux).
From source:
git clone https://github.com/djwmarcx/better-mealie-mcp
cd better-mealie-mcp
uv sync # install deps
cp .env.example .env # then edit .env with your Mealie URL + tokenAuth (set in .env or the environment):
Var | Meaning |
| Mealie base URL (default |
| Long-lived API token (preferred) — Mealie → Profile → Manage API Tokens |
| Alternative: logs in at startup to fetch a token |
| Per-request timeout, seconds (default 60) |
| Verify TLS cert; |
| MCP name advertised to clients (default |
| Expose only these API groups, comma-separated (e.g. |
| Expose everything except these groups (e.g. |
| Trim redundant schema noise — default |
| Also collapse nullable |
| Emit per-tool output schemas + validate results — default |
Groups are the first path segment of the API (recipes, households, admin,
organizers, users, explore, foods, units, …). Unset = every tool.
INCLUDE wins if both are set. See TOOLS.md for the current
groups and what's in each, or let the
Setup Wizard pick them — its
group picker (with one-click packs like Cooking or Meal planning) fills
MEALIE_INCLUDE_TAGS for you.
Every tool this server exposes ships its JSON schema to the model on every request — that "idle context" is pure overhead until a tool is actually called. With all 259 tools the full schemas are ~240k tokens, so the server trims them. Three preset modes (all endpoints stay callable — only the schema detail the model sees changes):
Mode | Env | Idle context | What it does |
Lean (default) | (none — the default) | ~61k tok | Drops redundant |
Leanest |
| ~51k tok | Everything Lean does, plus collapses nullable |
Full |
| ~240k tok | Complete, untrimmed input and output schemas, with client-side result validation. Use only if your client relies on structured-output schemas. |
Everything the model needs to make a correct call (format, real
descriptions, required fields) is kept in every mode. Combine with tag
filtering above to shrink further — the
Setup Wizard shows a live token
estimate for your exact combination.
uv run better-mealie-mcp # stdio transport (for MCP clients)
uv run better-mealie-mcp --http 8000 # streamable-http on 127.0.0.1:8000
uv run server.py # same server, back-compat entry
fastmcp run fastmcp.json # via FastMCP project config (stdio)
fastmcp run fastmcp-http.json # via FastMCP project config (http)In --http mode the bind address comes from MCP_HOST (default 127.0.0.1;
the Docker image sets 0.0.0.0 so -p port mapping works).
docker run -d --name mealie -p 9925:9000 \
-e ALLOW_SIGNUP=true -e BASE_URL=http://localhost:9925 -e TZ=UTC \
ghcr.io/mealie-recipes/mealie:latestDefault admin login: changeme@example.com / MyPassword.
Exposing every endpoint is a lot of tools — a lot of idle context. Most
clients handle it fine. If yours caps tool counts or you want a leaner
context, trim the toolset with MEALIE_INCLUDE_TAGS / MEALIE_EXCLUDE_TAGS
(see Setup) or the wizard's group picker.
This MCP's version mirrors the Mealie version its spec targets — MCP
3.20.1 ⇒ Mealie v3.20.1. The server advertises it to clients, and
VERSIONS.md maps every release to its Mealie version and date.
MCP-only changes (features/fixes with no Mealie version change) ship as a
revision of the same Mealie version: the REVISION counter
bumps and the release/image tag gains a -r<n> suffix — e.g. v3.20.1-r2
(-r1 is the base and carries no suffix). A new Mealie version resets the
counter. :latest always points at the newest build.
openapi.json is a vendored copy of Mealie's spec. The
update-spec workflow runs daily and
auto-tracks the latest stable Mealie release (mealie:latest): it boots that
image, reads its real version from /api/app/about
(MEALIE_VERSION), pulls /openapi.json, regenerates
TOOLS.md + counts, and — only when the spec actually changed —
bumps the version and opens a pull request (main is protected, so every
change lands via PR). When that PR merges,
release-on-spec cuts a
release (spec attached,
notes listing added/removed tools). Volatile server-clock defaults are stripped
so an unchanged run is a true no-op.
To freeze on one release instead of tracking latest, set MEALIE_TAG_DEFAULT in
the workflow to a specific tag (e.g. v3.20.1), or run it manually with a
mealie_tag input (latest, nightly, or any tag).
A few endpoints (list_auth_oauth*) return 500 unless OIDC is configured on
the Mealie side — that's Mealie behavior, not the server.
Create One
Inputs: accept-language. Returns: object
Import One
Inputs: file_name (required), accept-language. Returns: object
Upload a .zip File to later be imported into Mealie
Inputs: archive (required), accept-language. Returns: object
Debug Openai
Inputs: provider_id (required), image, accept-language. Returns: object
Send Test Email
Inputs: email (required), accept-language. Returns: object
Create One
Inputs: name (required), accept-language. Returns: object
Create Ai Provider
Inputs: name (required), model (required), group_id (required), apiKey, +5 more. Returns: object
Create One
Inputs: name (required), groupId, accept-language. Returns: object
Purges all the images from the filesystem that aren't .webp
Inputs: accept-language. Returns: object
Deletes all the recipe folders that don't have names that are valid UUIDs
Inputs: accept-language. Returns: object
Clean Temp
Inputs: accept-language. Returns: object
Create One
Inputs: email (required), fullName (required), password (required), username (required), +13 more. Returns: object
Generates a reset token and returns it. This is an authenticated endpoint
Inputs: email (required), accept-language. Returns: object
Unlock Users
Inputs: force, accept-language. Returns: object
Logout
Inputs: accept-language.
Exchange a native client's authorization code for a Mealie token.
The native client owns PKCE and state, so the exchange happens server-side without a browser session cookie. This lets passkey-capable system-browser logins (e.g. Pocket ID) work, which the cookie-coupled web callback cannot support.
Inputs: code (required), redirect_uri (required), code_verifier (required), nonce.
Exchange a valid session token for a fresh one.
The new token carries over the remember-me choice recorded on the old one, so refreshing doesn't downgrade a remembered session to one that dies with the browser.
Inputs: no named parameters.
Get Token
Inputs: password, username, remember_me.
Create One
Inputs: text (required), recipeId (required), accept-language. Returns: object
Create One
Inputs: name (required), id, extras, aliases, +6 more. Returns: object
Create Ai Provider
Inputs: name (required), model (required), apiKey, baseUrl, +4 more. Returns: object
Test connectivity for an already-saved provider.
Accepts optional unsaved edits to test against instead of what's in the database - e.g.
while editing a provider, the caller may have changed the model/base_url but left the API
key blank (meaning "keep the existing one"), so a plain "unsaved" test can't be used since
it has no way to supply that key. An overrides.apiKey of "" is treated the same way: keep
the saved key rather than testing with an empty one.
Inputs: provider_id (required), body, accept-language. Returns: object
Test connectivity for a provider configuration before it has been saved.
Inputs: name (required), model (required), apiKey, baseUrl, +4 more. Returns: object
Create One
Inputs: name (required), color, accept-language. Returns: object
Merges the from_id label into the to_id label, then deletes from_id.
Inputs: toId (required), fromId (required), accept-language. Returns: object
Start Data Migration
Inputs: archive (required), migration_type (required), accept-language, add_migration_tag. Returns: object
Seed Foods
Inputs: locale (required), accept-language. Returns: object
Seed Units
Inputs: locale (required), accept-language. Returns: object
Create One
Inputs: name (required), slug, public, position, +3 more. Returns: object
Create One
Inputs: name (required), appriseUrl, accept-language. Returns: object
Test Notification
Inputs: item_id (required), accept-language.
Create Invite Token
Inputs: uses (required), groupId, householdId, accept-language. Returns: object
Email Invitation
Inputs: email (required), token (required), accept-language. Returns: object
Create One
Inputs: date (required), text, endDate, recipeId, +3 more. Returns: object
Enables the meal plan iCal feed, replacing any existing token so old feed URLs stop working
Inputs: accept-language. Returns: object
create_random_meal is a route that provides the randomized functionality for meal planners.
It operates by following the rules set out in the household's meal plan settings. If no settings
are set, it will return any random meal.
Refer to the meal plan settings routes for more information on how rules can be applied to the random meal selector.
Inputs: date (required), endDate, entryType, accept-language. Returns: object
Create One
Inputs: day, entryType, accept-language, queryFilterString. Returns: object
Create One
Inputs: url (required), actionType (required), accept-language. Returns: object
Trigger Action
Inputs: item_id (required), recipe_slug (required), recipe_scale, accept-language.
Create One
Inputs: shoppingListId (required), id, food, note, +12 more. Returns: object
Create Many
Inputs: body (required), accept-language. Returns: object
Create One
Inputs: name, extras, createdAt, update_at, +1 more. Returns: object
Add Recipe Ingredients To List
Inputs: body (required), item_id (required), accept-language. Returns: object
Remove Recipe Ingredients From List
Inputs: item_id (required), recipe_id (required), body, accept-language. Returns: object
Add Single Recipe Ingredients To List
Inputs: item_id (required), recipe_id (required), body, accept-language. Returns: object
Create One
Inputs: scheduledTime (required), url, name, enabled, +2 more. Returns: object
Test One
Inputs: item_id (required), accept-language.
Manually re-fires all previously scheduled webhooks for today
Inputs: accept-language.
Creates a Category in the database
Inputs: name (required), accept-language.
Merges the from_id category into the to_id category, then deletes from_id.
Inputs: toId (required), fromId (required), accept-language. Returns: object
Creates a Tag in the database
Inputs: name (required), accept-language.
Merges the from_id tag into the to_id tag, then deletes from_id.
Inputs: toId (required), fromId (required), accept-language. Returns: object
Create One
Inputs: name (required), accept-language, householdsWithTool. Returns: object
Merges the from_id tool into the to_id tool, then deletes from_id.
Inputs: toId (required), fromId (required), accept-language. Returns: object
Parse Ingredient
Inputs: ingredient (required), parser, accept-language. Returns: object
Parse Ingredients
Inputs: ingredients (required), parser, accept-language. Returns: object
Takes in a JSON string and loads data into the database as a new entry
Inputs: name (required), accept-language. Returns: object
Bulk Categorize Recipes
Inputs: recipes (required), categories (required), accept-language.
Bulk Delete Recipes
Inputs: recipes (required), accept-language.
Bulk Export Recipes
Inputs: recipes (required), exportType, accept-language.
Bulk Settings Recipes
Inputs: recipes (required), settings (required), accept-language.
Bulk Tag Recipes
Inputs: tags (required), recipes (required), accept-language.
Upload a file to store as a recipe asset
Inputs: file (required), icon (required), name (required), slug (required), +2 more. Returns: object
Download an image from a URL and store it as a recipe asset.
Inputs: url (required), slug (required), includeTags, accept-language, +1 more. Returns: object
Duplicates a recipe with a new custom name if given
Inputs: slug (required), name, accept-language. Returns: object
Scrape Image Url
Inputs: url (required), slug (required), includeTags, accept-language, +1 more. Returns: object
Create a recipe from any combination of content (HTML, JSON, or text), images, and a URL, using AI. Optionally specify a language for it to translate the recipe to.
Inputs: url, images, content, accept-language, +2 more. Returns: object
Create a recipe from any combination of content (HTML, JSON, or text), images, and a URL, using AI, streaming progress via SSE
Inputs: url, images, content, accept-language, +2 more.
Takes in raw HTML or a https://schema.org/Recipe object as a JSON string and parses it like a URL.
A complete recipe exported from Mealie (the JSON from an export zip, or the recipe as returned by the API) is imported with its full structure instead of being parsed as schema.org.
Inputs: data (required), url, includeTags, accept-language, +1 more. Returns: object
Takes in raw HTML or a https://schema.org/Recipe object as a JSON string and parses it like a URL, streaming progress via SSE.
A complete recipe exported from Mealie (the JSON from an export zip, or the recipe as returned by the API) is imported with its full structure instead of being parsed as schema.org.
Inputs: data (required), url, includeTags, accept-language, +1 more.
Takes in a URL and attempts to scrape data and load it into the database
Inputs: url (required), includeTags, accept-language, includeCategories. Returns: object
Takes in a URL and attempts to scrape data and load it into the database
Inputs: imports (required), accept-language.
Takes in a URL and attempts to scrape data and load it into the database, streaming progress via SSE
Inputs: url (required), includeTags, accept-language, includeCategories.
Create recipe from archive
Inputs: archive (required), accept-language.
Test Parse Recipe Url
Inputs: url (required), useOpenAI, accept-language.
Create One
Inputs: subject (required), recipeId (required), eventType (required), image, +4 more. Returns: object
Create One
Inputs: name (required), id, extras, aliases, +9 more. Returns: object
Create api_token in the Database
Inputs: name (required), integrationId, accept-language. Returns: object
Adds a recipe to the user's favorites
Inputs: id (required), slug (required), accept-language.
Updates a User Image
Inputs: id (required), profile (required), accept-language.
Sets the user's rating for a recipe
Inputs: id (required), slug (required), rating, isFavorite, +1 more.
Sends an email with a reset link to the user
Inputs: email (required), accept-language.
Register New User
Inputs: email (required), fullName (required), password (required), username (required), +9 more. Returns: object
Resets the user password
Inputs: email (required), token (required), password (required), passwordConfirm (required).
Delete One
Inputs: file_name (required), accept-language. Returns: object
Reset a prompt to the default
Inputs: group_id (required), prompt_name (required), accept-language. Returns: object
Delete Ai Provider
Inputs: group_id (required), provider_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Reset a prompt to the default
Inputs: prompt_name (required), accept-language. Returns: object
Delete Ai Provider
Inputs: provider_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language.
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language.
Delete One
Inputs: item_id (required), accept-language. Returns: object
Disables the meal plan iCal feed
Inputs: accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete Many
Inputs: ids, accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Removes a recipe category from the database. Deleting a category does not impact a recipe. The category will be removed from any recipes that contain it
Inputs: item_id (required), accept-language.
Removes a recipe tag from the database. Deleting a tag does not impact a recipe. The tag will be removed from any recipes that contain it
Inputs: item_id (required), accept-language.
Delete One
Inputs: item_id (required), accept-language. Returns: object
Remove all exports data, including items on disk without database entry
Inputs: accept-language. Returns: object
Deletes a recipe by slug
Inputs: slug (required), accept-language.
Delete Recipe Image
Inputs: slug (required), accept-language.
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete One
Inputs: item_id (required), accept-language. Returns: object
Delete api_token from the Database
Inputs: token_id (required), accept-language. Returns: object
Removes a recipe from the user's favorites
Inputs: id (required), slug (required), accept-language.
Returns a token to download a file
Inputs: file_name (required), accept-language. Returns: object
Get Ai Provider
Inputs: group_id (required), provider_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
Get Household
Inputs: group_slug (required), household_slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
Get Recipe
Inputs: group_slug (required), recipe_slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get Ai Provider
Inputs: provider_id (required), accept-language. Returns: object
Get One Household
Inputs: household_slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Returns a single user belonging to the current group
Inputs: username_or_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Public iCal feed of the household's meal plan. No authentication is required; access is controlled by the secret token in the URL.
Inputs: token (required), tz, lang, side, +12 more.
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Returns recipe data for the current household
Inputs: recipe_slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Returns a recipe asset
Inputs: file_name (required), recipe_id (required).
Takes in a recipe id, returns the static image. This route is proxied in the docker image and should not hit the API in production
Inputs: file_name (required), recipe_id (required).
Takes in a recipe id and event timeline id, returns the static image. This route is proxied in the docker image and should not hit the API in production
Inputs: file_name (required), recipe_id (required), timeline_event_id (required).
Takes in a recipe slug, returns the static image. This route is proxied in the docker image and should not hit the API in production
Inputs: user_id (required), file_name (required).
Returns a list of recipes associated with the provided category.
Inputs: item_id (required), accept-language. Returns: object
Returns a category object with the associated recieps relating to the category
Inputs: category_slug (required), accept-language.
Returns a list of recipes associated with the provided tag.
Inputs: item_id (required), accept-language. Returns: object
Get One By Slug
Inputs: tag_slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One By Slug
Inputs: tool_slug (required), accept-language. Returns: object
Takes in a recipe's slug or id and returns all data for a recipe
Inputs: slug (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get One
Inputs: item_id (required), accept-language. Returns: object
Get Logged In User Rating For Recipe
Inputs: recipe_id (required), accept-language. Returns: object
Get general application information
Inputs: accept-language. Returns: object
Check App Config
Inputs: accept-language. Returns: object
Get App Statistics
Inputs: accept-language. Returns: object
Get All
Inputs: accept-language. Returns: object
Get general application information
Inputs: accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get Ai Prompts
Inputs: group_id (required), accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get the maintenance summary
Inputs: accept-language. Returns: object
Get Storage Details
Inputs: accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get general application information
Inputs: no named parameters. Returns: object
Get's the custom branding logo, if configured
Inputs: no named parameters.
returns helpful startup information
Inputs: no named parameters. Returns: object
Get's the current theme settings
Inputs: no named parameters. Returns: object
Oauth Login
Inputs: no named parameters.
Oauth Callback
Inputs: no named parameters.
Return the parameters a native client needs to build its own OIDC authorization request.
Inputs: no named parameters. Returns: object
Authenticate a user using a username forwarded by a trusted reverse proxy header
Inputs: no named parameters.
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
Get All
Inputs: group_slug (required), page, orderBy, perPage, +5 more. Returns: object
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
Get All
Inputs: group_slug (required), page, tags, foods, +16 more. Returns: object
Suggest Recipes
Inputs: group_slug (required), foods, limit, tools, +11 more. Returns: object
Get All
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
Returns a list of foods that are not used by any recipe
Inputs: accept-language. Returns: object
Get Ai Prompts
Inputs: accept-language. Returns: object
Get Ai Provider Settings
Inputs: accept-language. Returns: object
Get All Households
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get All
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
Returns a list of labels that are not used by any food or shopping list item
Inputs: accept-language. Returns: object
Returns all users belonging to the current group
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get Group Preferences
Inputs: accept-language. Returns: object
Get All
Inputs: report_type, accept-language. Returns: object
Returns the Group Data for the Current User
Inputs: accept-language. Returns: object
Get Storage
Inputs: accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get Invite Tokens
Inputs: accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, end_date, +7 more. Returns: object
Returns the token for the household's meal plan iCal feed, or null if the feed is disabled
Inputs: accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get Todays Meals
Inputs: accept-language.
Returns all users belonging to the current household
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get Household Preferences
Inputs: accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Returns the Household Data for the Current User
Inputs: accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get Statistics
Inputs: accept-language. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get Validation Text
Inputs: no named parameters.
Returns a list of available categories in the database
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
Returns a list of categories that do not contain any recipes
Inputs: accept-language. Returns: object
Returns a list of available tags in the database
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
Returns a list of tags that do not contain any recipes
Inputs: accept-language.
Get All
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
Returns a list of tools that are not used by any recipe
Inputs: accept-language. Returns: object
Get All
Inputs: page, tags, foods, tools, +15 more. Returns: object
Get Exported Data
Inputs: accept-language. Returns: object
Returns a token to download a file
Inputs: export_id (required), accept-language.
Get all comments for a recipe
Inputs: slug (required), accept-language. Returns: object
template_name: The name of the template to use to use in the exports listed. Template type will automatically
be set on the backend. Because of this, it's important that your templates have unique names. See available
names and formats in the /api/recipes/exports endpoint.
Inputs: slug (required), template_name (required), accept-language.
Get Recipe Formats And Templates
Inputs: accept-language. Returns: object
Suggest Recipes
Inputs: foods, limit, tools, orderBy, +10 more. Returns: object
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
Get All
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
Get user's favorited recipes
Inputs: id (required), accept-language. Returns: object
Get user's rated recipes
Inputs: id (required), accept-language. Returns: object
Get Logged In User
Inputs: accept-language. Returns: object
Get Logged In User Favorites
Inputs: accept-language. Returns: object
Get Logged In User Ratings
Inputs: accept-language. Returns: object
Uses a file token obtained by an active user to retrieve a file from the operating system.
Inputs: token.
Patch Many
Inputs: body (required), accept-language.
Updates a recipe by existing slug and data.
Inputs: slug__path (required), id, name, slug, +33 more.
Update a recipe's last made timestamp
Inputs: slug (required), timestamp (required), accept-language.
Append to or override a prompt. The group-wide instructions (global) can only be appended.
Inputs: mode (required), content (required), group_id (required), prompt_name (required), +1 more. Returns: object
Update Ai Provider
Inputs: name (required), model (required), group_id (required), provider_id (required), +6 more. Returns: object
Update One
Inputs: id (required), name (required), item_id (required), preferences, +2 more. Returns: object
Update One
Inputs: id (required), name (required), groupId (required), item_id (required), +2 more. Returns: object
Update One
Inputs: id (required), email (required), group (required), groupId (required), +19 more. Returns: object
Update One
Inputs: id (required), text (required), item_id (required), accept-language. Returns: object
Update One
Inputs: name (required), item_id (required), id, extras, +7 more. Returns: object
Merge One
Inputs: toFood (required), fromFood (required), accept-language. Returns: object
Append to or override a prompt. The group-wide instructions (global) can only be appended.
Inputs: mode (required), content (required), prompt_name (required), accept-language. Returns: object
Update Ai Provider
Inputs: name (required), model (required), provider_id (required), apiKey, +5 more. Returns: object
Update Ai Provider Settings
Inputs: audioProviderId (required), imageProviderId (required), defaultProviderId (required), accept-language. Returns: object
Update One
Inputs: id (required), name (required), groupId (required), item_id (required), +2 more. Returns: object
Update Group Preferences
Inputs: privateGroup, accept-language, showAnnouncements. Returns: object
Update Many
Inputs: body (required), accept-language. Returns: object
Update One
Inputs: name (required), item_id (required), slug, public, +4 more. Returns: object
Update One
Inputs: id (required), name (required), groupId (required), item_id (required), +5 more. Returns: object
Update One
Inputs: id (required), date (required), userId (required), groupId (required), +7 more. Returns: object
Update One
Inputs: item_id (required), day, entryType, accept-language, +1 more. Returns: object
Set Member Permissions
Inputs: userId (required), canInvite, canManage, canOrganize, +2 more. Returns: object
Update Household Preferences
Inputs: recipePublic, firstDayOfWeek, accept-language, privateHousehold, +6 more. Returns: object
Update One
Inputs: url (required), groupId (required), item_id (required), actionType (required), +2 more. Returns: object
Update Many
Inputs: body (required), accept-language. Returns: object
Update One
Inputs: item_id (required), shoppingListId (required), food, note, +12 more. Returns: object
Update One
Inputs: id (required), userId (required), groupId (required), item_id (required), +6 more. Returns: object
Update Label Settings
Inputs: body (required), item_id (required), accept-language. Returns: object
Update One
Inputs: item_id (required), scheduledTime (required), url, name, +3 more. Returns: object
Updates an existing Tag in the database
Inputs: name (required), item_id (required), accept-language. Returns: object
Updates an existing Tag in the database
Inputs: name (required), item_id (required), accept-language. Returns: object
Update One
Inputs: name (required), item_id (required), accept-language, householdsWithTool. Returns: object
Update Many
Inputs: body (required), accept-language.
Updates a recipe by existing slug and data.
Inputs: slug__path (required), id, name, slug, +33 more.
Update Recipe Image
Inputs: slug (required), image (required), extension (required), accept-language. Returns: object
Update One
Inputs: item_id (required), subject (required), image, eventMessage, +1 more. Returns: object
Update Event Image
Inputs: image (required), item_id (required), extension (required), accept-language. Returns: object
Update One
Inputs: name (required), item_id (required), id, extras, +10 more. Returns: object
Merge One
Inputs: toUnit (required), fromUnit (required), accept-language. Returns: object
Update User
Inputs: email (required), item_id (required), id, admin, +13 more.
Resets the User Password
Inputs: newPassword (required), accept-language, currentPassword.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 283 tools
Many tools are near-duplicates of one another: `list_groups_ai_providers_prompts`, `list_admin_groups_by_group_ai_providers_prompts`, and `list_admin_groups_by_group_ai_providers_providers_by_prov` all appear to fetch AI prompts/providers, and the same pattern repeats for categories, tags, tools, foods, and households across admin/group/explore scopes. Descriptions are almost uniformly generic ('Get One', 'Get All', 'Create One'), so an agent gets no help in choosing between the household, group, and admin variants. Several names are truncated mid-word ('_by_prov', '_by_recip', 'categories_b'), making the intended target impossible to infer from the name alone.
There is a recognizable verb prefix convention (list_/get_/create_/update_/delete_/patch_), which saves this from being chaotic. However, names are literal renderings of URL paths, producing 60+ character identifiers that are truncated at arbitrary points, and at least one tool (`create_households_shopping_lists_by_item_recipe_by_rec_2`) has a numeric disambiguation suffix, which is a naming failure. Nearly duplicate names differing only in scope prefix make length-based confusion likely.
283 tools is an extreme mismatch for what is essentially one recipe-management application; it is a wholesale 1:1 mirror of the Mealie OpenAPI spec. Dozens of tools exist only because admin, group, and explore path variants were each generated separately. An agent cannot practically select from a surface this size without heavy filtering.
As a full API mirror, the surface covers essentially every lifecycle operation in the domain: recipe CRUD, bulk actions, imports/scraping, organizers, meal plans, shopping lists, households, users, auth, backups, and media. The redundancy across scopes actually guarantees no capability is missing, though it is far more than complete rather than efficiently complete.
Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.
Household-aware cooking brain: pantry, meal suggestions, dietary safety, recipes, shopping lists.
Brie connects your assistant to saved recipes, household meal plans and shared grocery lists. Search your recipe library, import recipe links or text, and save a higher-protein or vegetarian adaptation as a named recipe version while preserving the original source. Prepare dinners around your household's preferences, review the proposal, then save the plan and rebuild its groceries. Start with a Brie account on the web and activate your personal Plus or Pro plan, or an eligible trial. Existing subscribers use their current account. Plus starts at $4.99 USD/month, with a seven-day trial for eligible new subscribers; current pricing and renewal terms appear before payment. Household membership alone does not include personal assistant access. Household operations require OAuth and your permission for the selected household. Public discovery exposes tool descriptions only. Eight recipe and grocery tools are available by default; add X-Brie-Capabilities: planning-preview for the thirteen-tool catalog including reviewed meal planning. No private nutrition logs, grocery purchases or billing access. Website: https://withbrie.app Setup: https://withbrie.app/agents Create your account: https://app.withbrie.app/signup?intent=assistant OpenClaw installation: https://clawhub.ai/brie/plugins/brie-openclaw
Persistent food journal for AI assistants. Log meals, save recipes, plan meals and track nutrition.
