Better Mealie MCP
🍲 Better Mealie MCP
MCP-сервер, открывающий все конечные точки Mealie API — все 250+ операций, ни одна не исключена. Управляйте рецептами, планами питания, списками покупок, домохозяйствами и многим другим из любого ИИ-ассистента на естественном языке.
Создано с помощью FastMCP from_openapi: инструменты
генерируются прямо из OpenAPI-спецификации Mealie, поэтому сервер остаётся синхронизированным с
Mealie, и ничего не поддерживается вручную. Полный список инструментов см. в TOOLS.md.
💬 Что с ним можно делать?
Вы говорите | Что происходит |
«Добавь рецепт курицы тикка масала по этой ссылке» | Скрапит и импортирует рецепт |
«Что я могу приготовить из того, что есть в кладовке?» | Ищет рецепты по вашим ингредиентам |
«Спланируй мои ужины на следующую неделю» | Создаёт записи плана питания |
«Составь список покупок для этих блюд» | Формирует единый список покупок |
«Помечай все мои супы как "зимние"» | Массово обновляет теги рецептов |
Related MCP server: Mealie MCP Server
🧙 Мастер настройки
Не пишите JSON вручную. Мастер проведёт вас через каждый выбор и выдаст готовую к вставке конфигурацию для вашей комбинации:
Установка — Docker-образ или из исходников.
Клиент — Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI или ChatGPT (он знает формат конфига каждого).
Подключение — stdio или HTTP, API-токен или имя пользователя/пароль.
Ограничение инструментов (необязательно) — сократите 259 инструментов до нужных групп, чтобы уменьшить контекст или вписаться в лимиты клиента. Начните с пакета (Готовка, Планирование питания, Обмен и просмотр, Администрирование и пользователи) или выбирайте группы по отдельности; нажмите ⓘ у группы, чтобы увидеть все инструменты внутри. Ваш выбор попадает в сгенерированный конфиг как
MEALIE_INCLUDE_TAGS.
🚀 Установка
Docker (образ GHCR):
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 HTTPОбразы публикуются при каждом релизе с тегами <mealie-version> и latest.
Внутри контейнера localhost — это сам контейнер; укажите MEALIE_BASE_URL на
host.docker.internal (macOS/Windows) или LAN-IP хоста (Linux).
Из исходников:
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 + tokenАвторизация (задаётся в .env или переменных окружения):
Переменная | Значение |
| Базовый URL Mealie (по умолчанию |
| Долгоживущий API-токен (предпочтительно) — Mealie → Профиль → Управление API-токенами |
| Альтернатива: вход при запуске для получения токена |
| Таймаут на запрос, секунды (по умолчанию 60) |
| Проверять TLS-сертификат; |
| Имя MCP, отображаемое клиентам (по умолчанию |
| Открывать только эти группы API, через запятую (например, |
| Открывать всё, кроме этих групп (например, |
| Убирать избыточный шум схем — по умолчанию |
| Также сворачивать nullable-объединения |
| Генерировать выходные схемы для каждого инструмента и проверять результаты — по умолчанию |
Группы — это первый сегмент пути API (recipes, households, admin,
organizers, users, explore, foods, units, …). Если не задано — доступны все инструменты.
INCLUDE имеет приоритет, если заданы оба. Актуальные группы и их содержимое см. в TOOLS.md,
или выберите их через мастер настройки — его
выбор групп (с пакетами в один клик, например Готовка или Планирование питания) заполнит
MEALIE_INCLUDE_TAGS за вас.
Размер контекста (детализация схем)
Каждый инструмент этого сервера отправляет свою JSON-схему модели при каждом запросе — этот «фоновый контекст» — чистые накладные расходы, пока инструмент не вызван. Со всеми 259 инструментами полные схемы занимают ~240k токенов, поэтому сервер их обрезает. Три предустановленных режима (все конечные точки остаются вызываемыми — меняется только детализация схемы, которую видит модель):
Режим | Окружение | Фоновый контекст | Что делает |
Компактный (по умолчанию) | (нет — по умолчанию) | ~61k ток | Убирает избыточные |
Максимально компактный |
| ~51k ток | Всё, что делает Компактный, плюс сворачивает nullable-объединения |
Полный |
| ~240k ток | Полные, необрезанные входные и выходные схемы с проверкой результатов на стороне клиента. Используйте только если ваш клиент полагается на схемы структурированного вывода. |
Всё, что нужно модели для корректного вызова (format, настоящие
description, обязательные поля), сохраняется в любом режиме. Комбинируйте с фильтрацией по тегам выше,
чтобы сократить ещё сильнее — мастер настройки показывает
живую оценку токенов для вашей конкретной комбинации.
▶️ Запуск
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)В режиме --http адрес привязки берётся из MCP_HOST (по умолчанию 127.0.0.1;
Docker-образ устанавливает 0.0.0.0, чтобы работал проброс портов -p).
🧪 Тестирование с локальным Mealie (Docker)
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:latestЛогин администратора по умолчанию: changeme@example.com / MyPassword.
📝 Примечания
Открытие всех конечных точек — это много инструментов и много фонового контекста. Большинство клиентов справляются нормально. Если ваш клиент ограничивает количество инструментов или вы хотите компактнее контекст, сократите набор инструментов с помощью
MEALIE_INCLUDE_TAGS/MEALIE_EXCLUDE_TAGS(см. Установка) или выбора групп в мастере.
Версионирование
Версия этого MCP зеркалирует версию Mealie, на спецификацию которой он рассчитан —
MCP 3.20.1 ⇒ Mealie v3.20.1. Сервер сообщает её клиентам, а
VERSIONS.md сопоставляет каждый релиз с его версией Mealie и датой.
Изменения только в MCP (функции/исправления без изменения версии Mealie) выходят как
ревизия той же версии Mealie: счётчик REVISION увеличивается,
а тег релиза/образа получает суффикс -r<n> — например, v3.20.1-r2
(-r1 — базовая версия без суффикса). Новая версия Mealie сбрасывает счётчик.
:latest всегда указывает на самую новую сборку.
openapi.json — это вендорная копия спецификации Mealie. Рабочий процесс
update-spec запускается ежедневно и
автоматически отслеживает последний стабильный релиз Mealie (mealie:latest): он запускает
этот образ, читает его реальную версию из /api/app/about
(MEALIE_VERSION), забирает /openapi.json, перегенерирует
TOOLS.md и счётчики и — только когда спецификация действительно изменилась —
поднимает версию и открывает pull request (main защищён, поэтому каждое изменение попадает через PR).
Когда этот PR сливается, release-on-spec создаёт
релиз (с приложенной спецификацией,
в примечаниях перечислены добавленные/удалённые инструменты). Нестабильные значения по умолчанию,
зависящие от часов сервера, удаляются, чтобы неизменённый запуск был настоящим no-op.
Чтобы зафиксироваться на одном релизе вместо отслеживания последнего, задайте MEALIE_TAG_DEFAULT
в рабочем процессе на конкретный тег (например, v3.20.1) или запустите его вручную с
входным параметром mealie_tag (latest, nightly или любой тег).
Несколько конечных точек (
list_auth_oauth*) возвращают 500, если на стороне Mealie не настроен OIDC — это поведение Mealie, а не сервера.
Available Tools
285 toolscreate_admin_backupsCreate Admin BackupsD
Create One
Inputs: accept-language. Returns: object
create_admin_backups_by_file_name_restoreCreate Admin Backups By File Name RestoreD
Import One
Inputs: file_name (required), accept-language. Returns: object
create_admin_backups_uploadCreate Admin Backups UploadC
Upload a .zip File to later be imported into Mealie
Inputs: archive (required), accept-language. Returns: object
create_admin_debug_openai_by_providerCreate Admin Debug Openai By ProviderD
Debug Openai
Inputs: provider_id (required), image, accept-language. Returns: object
create_admin_emailCreate Admin EmailC
Send Test Email
Inputs: email (required), accept-language. Returns: object
create_admin_groupsCreate Admin GroupsD
Create One
Inputs: name (required), accept-language. Returns: object
create_admin_groups_by_group_ai_providers_providersCreate Admin Groups By Group Ai Providers ProvidersC
Create Ai Provider
Inputs: name (required), model (required), group_id (required), apiKey, +5 more. Returns: object
create_admin_householdsCreate Admin HouseholdsD
Create One
Inputs: name (required), groupId, accept-language. Returns: object
create_admin_maintenance_clean_imagesCreate Admin Maintenance Clean ImagesA
Purges all the images from the filesystem that aren't .webp
Inputs: accept-language. Returns: object
create_admin_maintenance_clean_recipe_foldersCreate Admin Maintenance Clean Recipe FoldersA
Deletes all the recipe folders that don't have names that are valid UUIDs
Inputs: accept-language. Returns: object
create_admin_maintenance_clean_tempCreate Admin Maintenance Clean TempD
Clean Temp
Inputs: accept-language. Returns: object
create_admin_usersCreate Admin UsersD
Create One
Inputs: email (required), fullName (required), password (required), username (required), +13 more. Returns: object
create_admin_users_password_reset_tokenCreate Admin Users Password Reset TokenC
Generates a reset token and returns it. This is an authenticated endpoint
Inputs: email (required), accept-language. Returns: object
create_admin_users_unlockCreate Admin Users UnlockD
Unlock Users
Inputs: force, accept-language. Returns: object
create_auth_logoutCreate Auth LogoutD
Logout
Inputs: accept-language.
create_auth_oauth_native_tokenCreate Auth Oauth Native TokenA
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.
create_auth_refreshCreate Auth RefreshA
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.
create_auth_tokenCreate Auth TokenD
Get Token
Inputs: password, username, remember_me.
create_commentsCreate CommentsD
Create One
Inputs: text (required), recipeId (required), accept-language. Returns: object
create_foodsCreate FoodsD
Create One
Inputs: name (required), id, extras, aliases, +6 more. Returns: object
create_groups_ai_providers_providersCreate Groups Ai Providers ProvidersD
Create Ai Provider
Inputs: name (required), model (required), apiKey, baseUrl, +4 more. Returns: object
create_groups_ai_providers_providers_by_provider_testCreate Groups Ai Providers Providers By Provider TestA
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. The saved key and header/param values are only used while the base URL is unchanged; otherwise the caller must supply new ones.
Inputs: provider_id (required), body, accept-language. Returns: object
create_groups_ai_providers_providers_testCreate Groups Ai Providers Providers TestA
Test connectivity for a provider configuration before it has been saved.
Inputs: name (required), model (required), apiKey, baseUrl, +4 more. Returns: object
create_groups_labelsCreate Groups LabelsD
Create One
Inputs: name (required), color, accept-language. Returns: object
create_groups_labels_mergeCreate Groups Labels MergeA
Merges the from_id label into the to_id label, then deletes from_id.
Inputs: toId (required), fromId (required), accept-language. Returns: object
create_groups_migrationsCreate Groups MigrationsC
Start Data Migration
Inputs: archive (required), migration_type (required), accept-language, add_migration_tag. Returns: object
create_groups_seeders_foodsCreate Groups Seeders FoodsD
Seed Foods
Inputs: locale (required), accept-language. Returns: object
create_groups_seeders_unitsCreate Groups Seeders UnitsD
Seed Units
Inputs: locale (required), accept-language. Returns: object
create_households_cookbooksCreate Households CookbooksD
Create One
Inputs: name (required), slug, public, position, +3 more. Returns: object
create_households_events_notificationsCreate Households Events NotificationsD
Create One
Inputs: name (required), appriseUrl, accept-language. Returns: object
create_households_events_notifications_by_item_testCreate Households Events Notifications By Item TestD
Test Notification
Inputs: item_id (required), accept-language.
create_households_invitationsCreate Households InvitationsC
Create Invite Token
Inputs: uses (required), groupId, householdId, accept-language. Returns: object
create_households_invitations_emailCreate Households Invitations EmailD
Email Invitation
Inputs: email (required), token (required), accept-language. Returns: object
create_households_mealplansCreate Households MealplansD
Create One
Inputs: date (required), text, endDate, recipeId, +3 more. Returns: object
create_households_mealplans_icalCreate Households Mealplans IcalA
Enables the meal plan iCal feed, replacing any existing token so old feed URLs stop working
Inputs: accept-language. Returns: object
create_households_mealplans_randomCreate Households Mealplans RandomC
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_households_mealplans_rulesCreate Households Mealplans RulesD
Create One
Inputs: day, entryType, accept-language, queryFilterString. Returns: object
create_households_recipe_actionsCreate Households Recipe ActionsD
Create One
Inputs: url (required), actionType (required), accept-language. Returns: object
create_households_recipe_actions_by_item_trigger_by_reciCreate Households Recipe Actions By Item Trigger By ReciD
Trigger Action
Inputs: item_id (required), recipe_slug (required), recipe_scale, accept-language.
create_households_shopping_itemsCreate Households Shopping ItemsD
Create One
Inputs: shoppingListId (required), id, food, note, +12 more. Returns: object
create_households_shopping_items_create_bulkCreate Households Shopping Items Create BulkD
Create Many
Inputs: body (required), accept-language. Returns: object
create_households_shopping_listsCreate Households Shopping ListsD
Create One
Inputs: name, extras, createdAt, update_at, +1 more. Returns: object
create_households_shopping_lists_by_item_recipeCreate Households Shopping Lists By Item RecipeC
Add Recipe Ingredients To List
Inputs: body (required), item_id (required), accept-language. Returns: object
create_households_shopping_lists_by_item_recipe_by_rec_2Create Households Shopping Lists By Item Recipe By Rec 2C
Remove Recipe Ingredients From List
Inputs: item_id (required), recipe_id (required), body, accept-language. Returns: object
create_households_shopping_lists_by_item_recipe_by_recipCreate Households Shopping Lists By Item Recipe By RecipC
Add Single Recipe Ingredients To List
Inputs: item_id (required), recipe_id (required), body, accept-language. Returns: object
create_households_webhooksCreate Households WebhooksD
Create One
Inputs: scheduledTime (required), url, name, enabled, +2 more. Returns: object
create_households_webhooks_by_item_testCreate Households Webhooks By Item TestD
Test One
Inputs: item_id (required), accept-language.
create_households_webhooks_rerunCreate Households Webhooks RerunB
Manually re-fires all previously scheduled webhooks for today
Inputs: accept-language.
create_organizers_categoriesCreate Organizers CategoriesC
Creates a Category in the database
Inputs: name (required), accept-language. Returns: object
create_organizers_categories_mergeCreate Organizers Categories MergeA
Merges the from_id category into the to_id category, then deletes from_id.
Inputs: toId (required), fromId (required), accept-language. Returns: object
create_organizers_tagsCreate Organizers TagsC
Creates a Tag in the database
Inputs: name (required), accept-language. Returns: object
create_organizers_tags_mergeCreate Organizers Tags MergeA
Merges the from_id tag into the to_id tag, then deletes from_id.
Inputs: toId (required), fromId (required), accept-language. Returns: object
create_organizers_toolsCreate Organizers ToolsD
Create One
Inputs: name (required), accept-language, householdsWithTool. Returns: object
create_organizers_tools_mergeCreate Organizers Tools MergeB
Merges the from_id tool into the to_id tool, then deletes from_id.
Inputs: toId (required), fromId (required), accept-language. Returns: object
create_parser_ingredientCreate Parser IngredientC
Parse Ingredient
Inputs: ingredient (required), parser, accept-language. Returns: object
create_parser_ingredientsCreate Parser IngredientsD
Parse Ingredients
Inputs: ingredients (required), parser, accept-language. Returns: object
create_recipesCreate RecipesC
Takes in a JSON string and loads data into the database as a new entry
Inputs: name (required), accept-language. Returns: object
create_recipes_bulk_actions_categorizeCreate Recipes Bulk Actions CategorizeD
Bulk Categorize Recipes
Inputs: recipes (required), categories (required), accept-language.
create_recipes_bulk_actions_deleteCreate Recipes Bulk Actions DeleteC
Bulk Delete Recipes
Inputs: recipes (required), accept-language.
create_recipes_bulk_actions_exportCreate Recipes Bulk Actions ExportC
Bulk Export Recipes
Inputs: recipes (required), exportType, accept-language.
create_recipes_bulk_actions_settingsCreate Recipes Bulk Actions SettingsD
Bulk Settings Recipes
Inputs: recipes (required), settings (required), accept-language.
create_recipes_bulk_actions_tagCreate Recipes Bulk Actions TagD
Bulk Tag Recipes
Inputs: tags (required), recipes (required), accept-language.
create_recipes_by_slug_assetsCreate Recipes By Slug AssetsC
Upload a file to store as a recipe asset
Inputs: file (required), icon (required), name (required), slug (required), +2 more. Returns: object
create_recipes_by_slug_assets_urlCreate Recipes By Slug Assets UrlC
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
create_recipes_by_slug_duplicateCreate Recipes By Slug DuplicateC
Duplicates a recipe with a new custom name if given
Inputs: slug (required), name, accept-language. Returns: object
create_recipes_by_slug_imageCreate Recipes By Slug ImageD
Scrape Image Url
Inputs: url (required), slug (required), includeTags, accept-language, +1 more. Returns: object
create_recipes_create_aiCreate Recipes Create AiA
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_recipes_create_ai_streamCreate Recipes Create Ai StreamB
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.
create_recipes_create_html_or_jsonCreate Recipes Create Html Or JsonB
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
create_recipes_create_html_or_json_streamCreate Recipes Create Html Or Json StreamB
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.
create_recipes_create_urlCreate Recipes Create UrlC
Takes in a URL and attempts to scrape data and load it into the database
Inputs: url (required), includeTags, accept-language, includeCategories. Returns: object
create_recipes_create_url_bulkCreate Recipes Create Url BulkC
Takes in a URL and attempts to scrape data and load it into the database
Inputs: imports (required), accept-language.
create_recipes_create_url_streamCreate Recipes Create Url StreamC
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_recipes_create_zipCreate Recipes Create ZipC
Create recipe from archive
Inputs: archive (required), accept-language.
create_recipes_test_scrape_urlCreate Recipes Test Scrape UrlC
Test Parse Recipe Url
Inputs: url (required), useOpenAI, accept-language.
create_recipes_timeline_eventsCreate Recipes Timeline EventsD
Create One
Inputs: subject (required), recipeId (required), eventType (required), image, +4 more. Returns: object
create_unitsCreate UnitsD
Create One
Inputs: name (required), id, extras, aliases, +9 more. Returns: object
create_users_api_tokensCreate Users Api TokensD
Create api_token in the Database
Inputs: name (required), integrationId, accept-language. Returns: object
create_users_by_id_favorites_by_slugCreate Users By Id Favorites By SlugC
Adds a recipe to the user's favorites
Inputs: id (required), slug (required), accept-language.
create_users_by_id_imageCreate Users By Id ImageC
Updates a User Image
Inputs: id (required), profile (required), accept-language.
create_users_by_id_ratings_by_slugCreate Users By Id Ratings By SlugC
Sets the user's rating for a recipe
Inputs: id (required), slug (required), rating, isFavorite, +1 more.
create_users_forgot_passwordCreate Users Forgot PasswordC
Sends an email with a reset link to the user
Inputs: email (required), accept-language.
create_users_registerCreate Users RegisterC
Register New User
Inputs: email (required), fullName (required), password (required), username (required), +9 more. Returns: object
create_users_reset_passwordCreate Users Reset PasswordC
Resets the user password
Inputs: email (required), token (required), password (required), passwordConfirm (required).
delete_admin_backups_by_file_nameDelete Admin Backups By File NameD
Delete One
Inputs: file_name (required), accept-language. Returns: object
delete_admin_groups_by_group_ai_providers_prompts_by_proDelete Admin Groups By Group Ai Providers Prompts By ProC
Reset a prompt to the default
Inputs: group_id (required), prompt_name (required), accept-language. Returns: object
delete_admin_groups_by_group_ai_providers_providers_by_pDelete Admin Groups By Group Ai Providers Providers By PD
Delete Ai Provider
Inputs: group_id (required), provider_id (required), accept-language. Returns: object
delete_admin_groups_by_itemDelete Admin Groups By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_admin_households_by_itemDelete Admin Households By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_admin_users_by_itemDelete Admin Users By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_comments_by_itemDelete Comments By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_foods_by_itemDelete Foods By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_groups_ai_providers_prompts_by_prompt_nameDelete Groups Ai Providers Prompts By Prompt NameC
Reset a prompt to the default
Inputs: prompt_name (required), accept-language. Returns: object
delete_groups_ai_providers_providers_by_providerDelete Groups Ai Providers Providers By ProviderC
Delete Ai Provider
Inputs: provider_id (required), accept-language. Returns: object
delete_groups_labels_by_itemDelete Groups Labels By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_groups_reports_by_itemDelete Groups Reports By ItemD
Delete One
Inputs: item_id (required), accept-language.
delete_households_cookbooks_by_itemDelete Households Cookbooks By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_households_events_notifications_by_itemDelete Households Events Notifications By ItemD
Delete One
Inputs: item_id (required), accept-language.
delete_households_mealplans_by_itemDelete Households Mealplans By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_households_mealplans_icalDelete Households Mealplans IcalC
Disables the meal plan iCal feed
Inputs: accept-language. Returns: object
delete_households_mealplans_rules_by_itemDelete Households Mealplans Rules By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_households_recipe_actions_by_itemDelete Households Recipe Actions By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_households_shopping_itemsDelete Households Shopping ItemsC
Delete Many
Inputs: ids, accept-language. Returns: object
delete_households_shopping_items_by_itemDelete Households Shopping Items By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_households_shopping_lists_by_itemDelete Households Shopping Lists By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_households_webhooks_by_itemDelete Households Webhooks By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_organizers_categories_by_itemDelete Organizers Categories By ItemA
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.
delete_organizers_tags_by_itemDelete Organizers Tags By ItemA
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_organizers_tools_by_itemDelete Organizers Tools By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_recipes_bulk_actions_export_purgeDelete Recipes Bulk Actions Export PurgeA
Remove all exports data, including items on disk without database entry
Inputs: accept-language. Returns: object
delete_recipes_by_slugDelete Recipes By SlugC
Deletes a recipe by slug
Inputs: slug (required), accept-language. Returns: object
delete_recipes_by_slug_imageDelete Recipes By Slug ImageC
Delete Recipe Image
Inputs: slug (required), accept-language.
delete_recipes_timeline_events_by_itemDelete Recipes Timeline Events By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_units_by_itemDelete Units By ItemD
Delete One
Inputs: item_id (required), accept-language. Returns: object
delete_users_api_tokens_by_tokenDelete Users Api Tokens By TokenC
Delete api_token from the Database
Inputs: token_id (required), accept-language. Returns: object
delete_users_by_id_favorites_by_slugDelete Users By Id Favorites By SlugB
Removes a recipe from the user's favorites
Inputs: id (required), slug (required), accept-language.
get_admin_backups_by_file_nameGet Admin Backups By File NameC
Returns a token to download a file
Inputs: file_name (required), accept-language. Returns: object
get_admin_groups_by_group_ai_providers_providers_by_provGet Admin Groups By Group Ai Providers Providers By ProvD
Get Ai Provider
Inputs: group_id (required), provider_id (required), accept-language. Returns: object
get_admin_groups_by_itemGet Admin Groups By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_admin_households_by_itemGet Admin Households By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_admin_users_by_itemGet Admin Users By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_comments_by_itemGet Comments By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_explore_groups_by_group_slug_cookbooks_by_itemGet Explore Groups By Group Slug Cookbooks By ItemD
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
get_explore_groups_by_group_slug_foods_by_itemGet Explore Groups By Group Slug Foods By ItemD
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
get_explore_groups_by_group_slug_households_by_householdGet Explore Groups By Group Slug Households By HouseholdD
Get Household
Inputs: group_slug (required), household_slug (required), accept-language. Returns: object
get_explore_groups_by_group_slug_organizers_categories_bGet Explore Groups By Group Slug Organizers Categories BD
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
get_explore_groups_by_group_slug_organizers_tags_by_itemGet Explore Groups By Group Slug Organizers Tags By ItemD
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
get_explore_groups_by_group_slug_organizers_tools_by_iteGet Explore Groups By Group Slug Organizers Tools By IteD
Get One
Inputs: item_id (required), group_slug (required), accept-language. Returns: object
get_explore_groups_by_group_slug_recipes_by_recipe_slugGet Explore Groups By Group Slug Recipes By Recipe SlugD
Get Recipe
Inputs: group_slug (required), recipe_slug (required), accept-language. Returns: object
get_foods_by_itemGet Foods By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_groups_ai_providers_providers_by_providerGet Groups Ai Providers Providers By ProviderD
Get Ai Provider
Inputs: provider_id (required), accept-language. Returns: object
get_groups_households_by_household_slugGet Groups Households By Household SlugC
Get One Household
Inputs: household_slug (required), accept-language. Returns: object
get_groups_labels_by_itemGet Groups Labels By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_groups_members_by_username_orGet Groups Members By Username OrC
Returns a single user belonging to the current group
Inputs: username_or_id (required), accept-language. Returns: object
get_groups_reports_by_itemGet Groups Reports By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_households_cookbooks_by_itemGet Households Cookbooks By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_households_events_notifications_by_itemGet Households Events Notifications By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_households_mealplans_by_itemGet Households Mealplans By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_households_mealplans_ical_by_tokenGet Households Mealplans Ical By TokenB
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_households_mealplans_rules_by_itemGet Households Mealplans Rules By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_households_recipe_actions_by_itemGet Households Recipe Actions By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_households_self_recipes_by_recipe_slugGet Households Self Recipes By Recipe SlugC
Returns recipe data for the current household
Inputs: recipe_slug (required), accept-language. Returns: object
get_households_shopping_items_by_itemGet Households Shopping Items By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_households_shopping_lists_by_itemGet Households Shopping Lists By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_households_webhooks_by_itemGet Households Webhooks By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_media_recipes_by_recipe_assets_by_file_nameGet Media Recipes By Recipe Assets By File NameC
Returns a recipe asset
Inputs: file_name (required), recipe_id (required).
get_media_recipes_by_recipe_images_by_file_nameGet Media Recipes By Recipe Images By File NameC
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).
get_media_recipes_by_recipe_images_timeline_by_timelineGet Media Recipes By Recipe Images Timeline By TimelineB
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).
get_media_users_by_user_by_file_nameGet Media Users By User By File NameC
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).
get_organizers_categories_by_itemGet Organizers Categories By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_organizers_categories_slug_by_category_slugGet Organizers Categories Slug By Category SlugC
Returns a category object with the associated recieps relating to the category
Inputs: category_slug (required), accept-language. Returns: object
get_organizers_tags_by_itemGet Organizers Tags By ItemC
Returns a list of recipes associated with the provided tag.
Inputs: item_id (required), accept-language. Returns: object
get_organizers_tags_slug_by_tag_slugGet Organizers Tags Slug By Tag SlugD
Get One By Slug
Inputs: tag_slug (required), accept-language. Returns: object
get_organizers_tools_by_itemGet Organizers Tools By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_organizers_tools_slug_by_tool_slugGet Organizers Tools Slug By Tool SlugC
Get One By Slug
Inputs: tool_slug (required), accept-language. Returns: object
get_recipes_by_slugGet Recipes By SlugB
Takes in a recipe's slug or id and returns all data for a recipe
Inputs: slug (required), accept-language. Returns: object
get_recipes_timeline_events_by_itemGet Recipes Timeline Events By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_units_by_itemGet Units By ItemD
Get One
Inputs: item_id (required), accept-language. Returns: object
get_users_self_ratings_by_recipeGet Users Self Ratings By RecipeC
Get Logged In User Rating For Recipe
Inputs: recipe_id (required), accept-language. Returns: object
list_admin_aboutList Admin AboutC
Get general application information
Inputs: accept-language. Returns: object
list_admin_about_checkList Admin About CheckD
Check App Config
Inputs: accept-language. Returns: object
list_admin_about_statisticsList Admin About StatisticsC
Get App Statistics
Inputs: accept-language. Returns: object
list_admin_backupsList Admin BackupsD
Get All
Inputs: accept-language. Returns: object
list_admin_emailList Admin EmailC
Get general application information
Inputs: accept-language. Returns: object
list_admin_groupsList Admin GroupsD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_admin_groups_by_group_ai_providers_promptsList Admin Groups By Group Ai Providers PromptsD
Get Ai Prompts
Inputs: group_id (required), accept-language. Returns: object
list_admin_householdsList Admin HouseholdsD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_admin_maintenanceList Admin MaintenanceC
Get the maintenance summary
Inputs: accept-language. Returns: object
list_admin_maintenance_storageList Admin Maintenance StorageC
Get Storage Details
Inputs: accept-language. Returns: object
list_admin_usersList Admin UsersD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_app_aboutList App AboutB
Get general application information
Inputs: no named parameters. Returns: object
list_app_about_branding_logoList App About Branding LogoB
Get's the custom branding logo, if configured
Inputs: no named parameters.
list_app_about_startup_infoList App About Startup InfoC
returns helpful startup information
Inputs: no named parameters. Returns: object
list_app_about_themeList App About ThemeA
Get's the current theme settings
Inputs: no named parameters. Returns: object
list_auth_oauthList Auth OauthC
Oauth Login
Inputs: no named parameters.
list_auth_oauth_callbackList Auth Oauth CallbackC
Oauth Callback
Inputs: no named parameters.
list_auth_oauth_native_configList Auth Oauth Native ConfigA
Return the parameters a native client needs to build its own OIDC authorization request.
Inputs: no named parameters. Returns: object
list_auth_reverse_proxyList Auth Reverse ProxyC
Authenticate a user using a username forwarded by a trusted reverse proxy header
Inputs: no named parameters.
list_commentsList CommentsD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_explore_groups_by_group_slug_cookbooksList Explore Groups By Group Slug CookbooksD
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
list_explore_groups_by_group_slug_foodsList Explore Groups By Group Slug FoodsD
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
list_explore_groups_by_group_slug_householdsList Explore Groups By Group Slug HouseholdsD
Get All
Inputs: group_slug (required), page, orderBy, perPage, +5 more. Returns: object
list_explore_groups_by_group_slug_organizers_categoriesList Explore Groups By Group Slug Organizers CategoriesD
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
list_explore_groups_by_group_slug_organizers_tagsList Explore Groups By Group Slug Organizers TagsD
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
list_explore_groups_by_group_slug_organizers_toolsList Explore Groups By Group Slug Organizers ToolsD
Get All
Inputs: group_slug (required), page, search, orderBy, +6 more. Returns: object
list_explore_groups_by_group_slug_recipesList Explore Groups By Group Slug RecipesD
Get All
Inputs: group_slug (required), page, tags, foods, +16 more. Returns: object
list_explore_groups_by_group_slug_recipes_suggestionsList Explore Groups By Group Slug Recipes SuggestionsD
Suggest Recipes
Inputs: group_slug (required), foods, limit, tools, +11 more. Returns: object
list_foodsList FoodsD
Get All
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
list_foods_emptyList Foods EmptyB
Returns a list of foods that are not used by any recipe
Inputs: accept-language. Returns: object
list_groups_ai_providers_promptsList Groups Ai Providers PromptsD
Get Ai Prompts
Inputs: accept-language. Returns: object
list_groups_ai_providers_settingsList Groups Ai Providers SettingsC
Get Ai Provider Settings
Inputs: accept-language. Returns: object
list_groups_householdsList Groups HouseholdsC
Get All Households
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_groups_labelsList Groups LabelsD
Get All
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
list_groups_labels_emptyList Groups Labels EmptyB
Returns a list of labels that are not used by any food or shopping list item
Inputs: accept-language. Returns: object
list_groups_membersList Groups MembersB
Returns all users belonging to the current group
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_groups_preferencesList Groups PreferencesC
Get Group Preferences
Inputs: accept-language. Returns: object
list_groups_reportsList Groups ReportsD
Get All
Inputs: report_type, accept-language. Returns: object
list_groups_selfList Groups SelfB
Returns the Group Data for the Current User
Inputs: accept-language. Returns: object
list_groups_storageList Groups StorageC
Get Storage
Inputs: accept-language. Returns: object
list_households_cookbooksList Households CookbooksD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_households_cookbooks_by_item_pdfList Households Cookbooks By Item PdfD
Get One As Pdf
Inputs: item_id (required), include_images, accept-language.
list_households_events_notificationsList Households Events NotificationsD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_households_invitationsList Households InvitationsC
Get Invite Tokens
Inputs: accept-language. Returns: object
list_households_mealplansList Households MealplansD
Get All
Inputs: page, orderBy, perPage, end_date, +7 more. Returns: object
list_households_mealplans_icalList Households Mealplans IcalB
Returns the token for the household's meal plan iCal feed, or null if the feed is disabled
Inputs: accept-language. Returns: object
list_households_mealplans_rulesList Households Mealplans RulesD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_households_mealplans_todayList Households Mealplans TodayC
Get Todays Meals
Inputs: accept-language.
list_households_membersList Households MembersC
Returns all users belonging to the current household
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_households_preferencesList Households PreferencesD
Get Household Preferences
Inputs: accept-language. Returns: object
list_households_recipe_actionsList Households Recipe ActionsD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_households_selfList Households SelfC
Returns the Household Data for the Current User
Inputs: accept-language. Returns: object
list_households_shopping_itemsList Households Shopping ItemsD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_households_shopping_listsList Households Shopping ListsD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_households_statisticsList Households StatisticsD
Get Statistics
Inputs: accept-language. Returns: object
list_households_webhooksList Households WebhooksD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_media_docker_validate_txtList Media Docker Validate TxtC
Get Validation Text
Inputs: no named parameters.
list_organizers_categoriesList Organizers CategoriesC
Returns a list of available categories in the database
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
list_organizers_categories_emptyList Organizers Categories EmptyA
Returns a list of categories that do not contain any recipes
Inputs: accept-language. Returns: object
list_organizers_tagsList Organizers TagsC
Returns a list of available tags in the database
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
list_organizers_tags_emptyList Organizers Tags EmptyB
Returns a list of tags that do not contain any recipes
Inputs: accept-language. Returns: object
list_organizers_toolsList Organizers ToolsD
Get All
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
list_organizers_tools_emptyList Organizers Tools EmptyB
Returns a list of tools that are not used by any recipe
Inputs: accept-language. Returns: object
list_recipesList RecipesD
Get All
Inputs: page, tags, foods, tools, +15 more. Returns: object
list_recipes_bulk_actions_exportList Recipes Bulk Actions ExportD
Get Exported Data
Inputs: accept-language. Returns: object
list_recipes_bulk_actions_export_by_export_downloadList Recipes Bulk Actions Export By Export DownloadC
Returns a token to download a file
Inputs: export_id (required), accept-language.
list_recipes_by_slug_commentsList Recipes By Slug CommentsC
Get all comments for a recipe
Inputs: slug (required), accept-language. Returns: object
list_recipes_by_slug_exportsList Recipes By Slug ExportsC
Parameters
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.
list_recipes_by_slug_exports_pdfList Recipes By Slug Exports PdfC
Get Recipe As Pdf
Inputs: slug (required), include_images, accept-language.
list_recipes_exportsList Recipes ExportsC
Get Recipe Formats And Templates
Inputs: accept-language. Returns: object
list_recipes_suggestionsList Recipes SuggestionsD
Suggest Recipes
Inputs: foods, limit, tools, orderBy, +10 more. Returns: object
list_recipes_timeline_eventsList Recipes Timeline EventsD
Get All
Inputs: page, orderBy, perPage, queryFilter, +4 more. Returns: object
list_unitsList UnitsD
Get All
Inputs: page, search, orderBy, perPage, +5 more. Returns: object
list_users_by_id_favoritesList Users By Id FavoritesC
Get user's favorited recipes
Inputs: id (required), accept-language. Returns: object
list_users_by_id_ratingsList Users By Id RatingsC
Get user's rated recipes
Inputs: id (required), accept-language. Returns: object
list_users_selfList Users SelfB
Get Logged In User
Inputs: accept-language. Returns: object
list_users_self_favoritesList Users Self FavoritesC
Get Logged In User Favorites
Inputs: accept-language. Returns: object
list_users_self_ratingsList Users Self RatingsC
Get Logged In User Ratings
Inputs: accept-language. Returns: object
list_utils_downloadList Utils DownloadB
Uses a file token obtained by an active user to retrieve a file from the operating system.
Inputs: token.
patch_recipesPatch RecipesD
Patch Many
Inputs: body (required), accept-language. Returns: object
patch_recipes_by_slugPatch Recipes By SlugC
Updates a recipe by existing slug and data.
Inputs: slug__path (required), id, name, slug, +32 more. Returns: object
patch_recipes_by_slug_last_madePatch Recipes By Slug Last MadeC
Update a recipe's last made timestamp
Inputs: slug (required), timestamp (required), accept-language. Returns: object
update_admin_groups_by_group_ai_providers_prompts_by_proUpdate Admin Groups By Group Ai Providers Prompts By ProB
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_admin_groups_by_group_ai_providers_providers_by_pUpdate Admin Groups By Group Ai Providers Providers By PC
Update Ai Provider
Inputs: name (required), model (required), group_id (required), provider_id (required), +6 more. Returns: object
update_admin_groups_by_itemUpdate Admin Groups By ItemD
Update One
Inputs: id (required), name (required), item_id (required), preferences, +2 more. Returns: object
update_admin_households_by_itemUpdate Admin Households By ItemD
Update One
Inputs: id (required), name (required), groupId (required), item_id (required), +2 more. Returns: object
update_admin_users_by_itemUpdate Admin Users By ItemD
Update One
Inputs: id (required), email (required), group (required), groupId (required), +19 more. Returns: object
update_comments_by_itemUpdate Comments By ItemD
Update One
Inputs: id (required), text (required), item_id (required), accept-language. Returns: object
update_foods_by_itemUpdate Foods By ItemD
Update One
Inputs: name (required), item_id (required), id, extras, +7 more. Returns: object
update_foods_mergeUpdate Foods MergeD
Merge One
Inputs: toFood (required), fromFood (required), accept-language. Returns: object
update_groups_ai_providers_prompts_by_prompt_nameUpdate Groups Ai Providers Prompts By Prompt NameA
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_groups_ai_providers_providers_by_providerUpdate Groups Ai Providers Providers By ProviderC
Update Ai Provider
Inputs: name (required), model (required), provider_id (required), apiKey, +5 more. Returns: object
update_groups_ai_providers_settingsUpdate Groups Ai Providers SettingsD
Update Ai Provider Settings
Inputs: audioProviderId (required), imageProviderId (required), defaultProviderId (required), accept-language. Returns: object
update_groups_labels_by_itemUpdate Groups Labels By ItemD
Update One
Inputs: id (required), name (required), groupId (required), item_id (required), +2 more. Returns: object
update_groups_preferencesUpdate Groups PreferencesD
Update Group Preferences
Inputs: privateGroup, accept-language, showAnnouncements. Returns: object
update_households_cookbooksUpdate Households CookbooksC
Update Many
Inputs: body (required), accept-language. Returns: object
update_households_cookbooks_by_itemUpdate Households Cookbooks By ItemD
Update One
Inputs: name (required), item_id (required), slug, public, +4 more. Returns: object
update_households_events_notifications_by_itemUpdate Households Events Notifications By ItemD
Update One
Inputs: id (required), name (required), groupId (required), item_id (required), +5 more. Returns: object
update_households_mealplans_by_itemUpdate Households Mealplans By ItemD
Update One
Inputs: id (required), date (required), userId (required), groupId (required), +7 more. Returns: object
update_households_mealplans_rules_by_itemUpdate Households Mealplans Rules By ItemD
Update One
Inputs: item_id (required), day, entryType, accept-language, +1 more. Returns: object
update_households_permissionsUpdate Households PermissionsD
Set Member Permissions
Inputs: userId (required), canInvite, canManage, canOrganize, +2 more. Returns: object
update_households_preferencesUpdate Households PreferencesD
Update Household Preferences
Inputs: recipePublic, firstDayOfWeek, accept-language, privateHousehold, +6 more. Returns: object
update_households_recipe_actions_by_itemUpdate Households Recipe Actions By ItemD
Update One
Inputs: url (required), groupId (required), item_id (required), actionType (required), +2 more. Returns: object
update_households_shopping_itemsUpdate Households Shopping ItemsD
Update Many
Inputs: body (required), accept-language. Returns: object
update_households_shopping_items_by_itemUpdate Households Shopping Items By ItemD
Update One
Inputs: item_id (required), shoppingListId (required), food, note, +12 more. Returns: object
update_households_shopping_lists_by_itemUpdate Households Shopping Lists By ItemD
Update One
Inputs: id (required), userId (required), groupId (required), item_id (required), +6 more. Returns: object
update_households_shopping_lists_by_item_label_settingsUpdate Households Shopping Lists By Item Label SettingsD
Update Label Settings
Inputs: body (required), item_id (required), accept-language. Returns: object
update_households_webhooks_by_itemUpdate Households Webhooks By ItemD
Update One
Inputs: item_id (required), scheduledTime (required), url, name, +3 more. Returns: object
update_organizers_categories_by_itemUpdate Organizers Categories By ItemC
Updates an existing Category in the database
Inputs: name (required), item_id (required), accept-language. Returns: object
update_organizers_tags_by_itemUpdate Organizers Tags By ItemC
Updates an existing Tag in the database
Inputs: name (required), item_id (required), accept-language. Returns: object
update_organizers_tools_by_itemUpdate Organizers Tools By ItemD
Update One
Inputs: name (required), item_id (required), accept-language, householdsWithTool. Returns: object
update_recipesUpdate RecipesD
Update Many
Inputs: body (required), accept-language. Returns: object
update_recipes_by_slugUpdate Recipes By SlugC
Updates a recipe by existing slug and data.
Inputs: slug__path (required), id, name, slug, +32 more. Returns: object
update_recipes_by_slug_imageUpdate Recipes By Slug ImageC
Update Recipe Image
Inputs: slug (required), image (required), extension (required), accept-language. Returns: object
update_recipes_timeline_events_by_itemUpdate Recipes Timeline Events By ItemD
Update One
Inputs: item_id (required), subject (required), image, eventMessage, +1 more. Returns: object
update_recipes_timeline_events_by_item_imageUpdate Recipes Timeline Events By Item ImageC
Update Event Image
Inputs: image (required), item_id (required), extension (required), accept-language. Returns: object
update_units_by_itemUpdate Units By ItemD
Update One
Inputs: name (required), item_id (required), id, extras, +10 more. Returns: object
update_units_mergeUpdate Units MergeD
Merge One
Inputs: toUnit (required), fromUnit (required), accept-language. Returns: object
update_users_by_itemUpdate Users By ItemD
Update User
Inputs: email (required), item_id (required), id, admin, +13 more.
update_users_passwordUpdate Users PasswordC
Resets the User Password
Inputs: newPassword (required), accept-language, currentPassword.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 285 tools
The set contains many overlapping tools across scopes: list_recipes vs list_explore_groups_by_group_slug_recipes, multiple admin/group/household CRUD variants, and several recipe-creation tools (create_url, create_url_bulk, create_url_stream, create_html_or_json, create_ai). Descriptions help somewhat, but an agent can easily misselect between near-duplicate endpoints.
Most names are verb_noun, but many are long path-derived names with truncated segments (e.g. create_households_shopping_lists_by_item_recipe_by_rec_2, get_admin_groups_by_group_ai_providers_providers_by_prov). Some verbs are misleading, such as create_auth_token for 'Get Token' and list_auth_oauth for 'Oauth Login'.
285 tools is an extreme mismatch for an MCP server, far beyond a well-scoped set. The surface mirrors nearly the entire Mealie API, including admin, explore, media, and duplicate scoped variants, making the toolset unwieldy for agent use.
The surface is very complete, covering recipes, foods, units, organizers, meal plans, shopping lists, households, groups, admin, auth, media, and parser operations. Minor gaps may exist around some lifecycle operations, but core CRUD and domain workflows are broadly represented.
Maintenance
Related MCP Connectors
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.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Mealie for recipe management, meal planning, and shopping list operations. Supports searching and managing recipes, creating meal plans, and generating shopping lists from recipes or meal plans.7MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Mealie recipe databases, allowing users to manage and query their recipes through natural language conversations.17 npmMIT
- AlicenseNot gradedqualityDmaintenanceExposes Mealie recipe manager as LLM-callable tools for searching recipes, managing meal plans, and editing shopping lists.MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.27209 npm8MIT