List all products currently in stock with their quantities.

Returns each product with its ID, name, and amount. Use this to see what is available before adding, consuming, or transferring stock.

List products that are expiring soon, already expired, or below minimum stock.

Useful for daily checks or deciding what to consume or restock first.

Get detailed stock information for a single product.

Returns current amount, best-before date, and product metadata.

Add stock for a product (e.g. after a purchase).

Consume stock for a product (reduces the quantity on hand).

Move stock of a product to a different storage location.

Correct the stock level for a product by setting an absolute quantity.

Use this when the actual count differs from what Grocy shows — e.g. after a manual count. This replaces the current amount, not adds to it.

Mark stock units as opened (e.g. an opened bottle of milk).

Search for products by name substring or barcode.

Returns matching product names and IDs. Use this when you are not sure of the exact product name. For a direct barcode lookup with stock details, use stock_barcode_lookup_tool instead.

Look up a product and its current stock level by exact barcode.

Returns the product name and quantity in stock. For partial or name-based searches, use stock_search_tool instead.

View all items on a shopping list.

Returns each item with its ID, product name, quantity, and optional note. Item IDs are needed for update and remove operations.

Add a product to the shopping list.

Update fields on an existing shopping list item.

Use shopping_list_view_tool first to find the item_id.

Remove a single item from the shopping list.

Use shopping_list_view_tool first to find the item_id.

Remove ALL items from a shopping list. This cannot be undone.

Add all products that are below their minimum stock level to the shopping list.

This is a bulk operation — it scans all products and adds any that are below their configured minimum stock quantity.

Change the quantity for a shopping list item.

A simpler alternative to shopping_list_update_tool when you only need to change the amount.

Set or update the note on a shopping list item.

A simpler alternative to shopping_list_update_tool when you only need to change the note.

List all recipes with their IDs and descriptions.

Use this to discover available recipes before checking fulfillment or consuming ingredients.

Show full details for a recipe including all ingredients and amounts.

Check whether a recipe can be made with current stock.

Reports whether all ingredients are available and how many are missing.

Consume stock for all ingredients of a recipe (as if you cooked it).

This deducts each ingredient amount from stock. Check fulfillment first to make sure all ingredients are available.

Add only the missing ingredients for a recipe to the shopping list.

Does not add ingredients that are already sufficiently in stock.

Create a new recipe in Grocy.

Create a recipe with ingredients specified by product name instead of ID.

This is the easier alternative to recipe_create_tool — you can use product names directly, and they will be resolved automatically.

Update a recipe's name or description.

Add an ingredient to an existing recipe using the product name.

Remove an ingredient from a recipe.

Use recipe_details_tool to see ingredient position IDs.

Preview what stock would be consumed without actually consuming.

Shows each ingredient, the amount needed, and whether there is enough in stock. Use this before recipe_consume_tool to verify.

List all chores with their IDs and next scheduled execution time.

Use this to see what chores exist and when they are due next.

List chores that are past their scheduled execution time.

Returns only chores where the next execution time is in the past.

Mark a chore as done.

This records an execution and advances the next scheduled time.

Undo the most recent execution of a chore.

Removes the last recorded execution and reverts the schedule.

Create a new chore in Grocy.

List all storage locations in Grocy.

Shows location names, IDs, and whether each is a freezer.

Create a new storage location.

View recent stock transaction history.

Shows the 50 most recent stock changes (purchases, consumption, transfers, inventory corrections). Optionally filter by product.

List tasks (to-do items separate from chores).

By default shows only incomplete tasks.

Create a new task.

Mark a task as done.

Mark a task as not completed.

Delete a task. This cannot be undone.

List all meal plan entries sorted by date.

Shows scheduled meals with their dates, recipe names, and notes.

Add an entry to the meal plan.

Either specify a recipe or a free-text note (or both).

Remove an entry from the meal plan.

Add missing ingredients for all planned recipes to the shopping list.

Scans the meal plan (optionally filtered by date range), finds all scheduled recipes, and adds their unfulfilled ingredients to the shopping list. This is the "plan meals → shop" workflow in one step.

Return a structured meal-plan summary with recipe and section names.

List first-class catalog and metadata entities.

Supported entities include shopping_lists, shopping_locations, quantity_units, quantity_unit_conversions, product_groups, task_categories, meal_plan_sections, products_last_purchased, and products_average_price.

Return details for a first-class catalog entity record.

Create a record in a writable first-class catalog entity.

Update a record in a writable first-class catalog entity.

List batteries with next estimated charge times.

Return detailed information for a battery by name or ID.

Return batteries due within the next given number of days.

Return batteries that are already overdue for charging.

Track a battery charge cycle.

Return charge-cycle history for a battery.

Undo a tracked battery charge cycle.

Create a battery object.

Update a battery object.

List equipment with linked battery visibility where available.

Return details for an equipment item by name or ID.

Create an equipment item.

Update an equipment item.

Return a read-only planning summary across tasks, chores, batteries, and meal plan.

Return the raw Grocy iCal export.

Return the public Grocy iCal sharing link.

Download a Grocy-managed file as base64 content.

Upload a Grocy-managed file from base64 content.

Delete a Grocy-managed file.

Trigger printing of a stock-entry label.

Trigger printing of a product label.

Trigger printing of a recipe label.

Trigger printing of a chore label.

Trigger printing of a battery label.

Trigger thermal printing of the shopping list.

Search products, recipes, chores, locations, tasks, or supported metadata domains.

Describe a Grocy entity and its discovered fields.

Return discovered sample fields for a Grocy entity.

Preview product matches for normalized external items.

Use this when an LLM or another client has already converted a receipt, chat message, or image into a normalized item list and you need Grocy product IDs before applying stock changes.

Preview Grocy stock additions for normalized external items.

This uses the same matching contract as workflow_match_products_preview_tool, but is named for the common "I bought these groceries" workflow.

Apply confirmed stock additions using explicit Grocy product IDs.

Apply only confirmed IDs from a prior preview step. This tool does not resolve names implicitly.

Preview shopping-list removals and amount updates after a purchase.

Provide confirmed Grocy product IDs for what was purchased and this tool will propose explicit shopping-item actions without applying them.

Apply explicit shopping-list reconciliation actions from a preview step.

Show Grocy server version, PHP version, and SQLite version.

Useful for verifying connectivity and checking compatibility.

List all objects of a Grocy entity type.

This is a generic tool for browsing any Grocy data table.

Create a new object of any Grocy entity type.

This is a low-level tool — prefer the domain-specific create tools (recipe_create_tool, chore_create_tool) when available.

Update an existing Grocy entity object by its ID.

Only the fields provided in data are changed; other fields are left as-is.

Delete a Grocy entity object by its ID. This cannot be undone.