MCP App Store
by KeenEthics
Grocer icon

Grocer MCP Server for ChatGPT

By MIRLAN KAIYRBAEV

Overview

Connect your Grocer account to read and manage synced grocery lists, edit items, organize them by category, and delete selected items or lists after confirmation. Shared lists follow your Grocer permissions.

How to connect

  1. ChatGPT: Open the Grocer listing in the ChatGPT app directory and choose Connect. ChatGPT listing Grocer exposes 23 tools here.

Tools

add_grocery_list_collaborator

ChatGPT
Use this when the user wants to share a Grocer list with someone they already share with, as returned by list_grocery_collaborators. Adds them to the list right away, with no invite link; they see it in their Grocer app. Only the list's owner can do this. An editor can add, edit and check off items; a viewer can only read. Use editor unless the user asks for read-only access. For anyone not returned by list_grocery_collaborators, use share_grocery_list.

add_item

ChatGPT
Use this when the user asks to add one item to an existing Grocer list. Generate a fresh UUID for item_id and reuse it only if retrying this exact addition. Viewers cannot add items.

add_items

ChatGPT
Use this when the user asks to add more than one item to an existing Grocer list, such as the ingredients for a recipe or a week of meals. If the user hasn't said which list to use, and hasn't picked one earlier in this chat, don't choose for them: find their lists with list_grocery_lists, then ask which one to add to or whether to create a new list. Prefer it over repeated add_item calls. Set each item's source to the recipe or meal it is for, so the user can tell recipes apart on the list, and its category to its aisle. Adds up to 100 items in one call, in the given order, after the list's current items; all are added or none are. Generate a fresh UUID for each item_id and reuse the same IDs only if retrying this exact addition. Viewers cannot add items.

copy_list

ChatGPT
Use this when the user wants a new Grocer list based on an existing one, such as starting this week's list from last week's. Copies the items in order, with their quantities, notes, recipes and chosen categories, and the list's category order, into a new list the user owns; the original is unchanged. By default every copied item is unchecked; checked_items "keep" copies each item's checked state, and "leave_out" copies only items not checked off yet. Without a title the copy is named "<title> Copy", as in the app. Anyone on a list, viewers too, can copy it. Generate a fresh UUID for new_list_id and reuse it only if retrying this exact copy; the copy is made all at once, and a retry returns it as it is.

create_category

ChatGPT
Use when the user asks to create a named category and move a specific item into it. Grocer currently saves custom categories on items, so an item is required and empty categories cannot be created. Identify the exact list and item first. Viewers cannot create categories.

create_list

ChatGPT
Use this when the user asks to create a new Grocer list. Generate a fresh UUID for list_id and reuse it only if retrying this exact creation.

delete_item

ChatGPT
Soft-delete one item after confirming its exact name and list with the user. Get the item with get_grocery_list first. Pass confirmation exactly as DELETE <item title> FROM <list title>, using the current titles returned by Grocer. Viewers cannot delete items.

delete_list

ChatGPT
Soft-delete an entire list and hide it from all members. Only its owner may do this. Confirm the exact list title with the user, then pass confirmation exactly as DELETE <list title>, using the current title returned by Grocer.

edit_item

ChatGPT
Change the name, quantity, or notes of one existing item. Identify the exact list and item first. Supply only fields the user asked to change. Viewers cannot edit items.

get_grocery_list

ChatGPT
Use this when the user wants to see the items and checked state in a specific Grocer list. First identify its ID with list_grocery_lists.

get_item_suggestions

ChatGPT
Use this when the user asks what they usually buy, what they might be forgetting, or to add their usual items. Returns items from the user's Grocer lists, ranked as the app's suggestions are: an item on more lists ranks higher, and older ones fade. With list_id, items already on that list are left out. With query, only items whose name contains it are returned. Nothing is added: show the suggestions and ask which to add, then use add_items with each one's category.

list_categories

ChatGPT
Find Grocer's built-in categories plus custom category names currently assigned to items in this list.

list_grocery_collaborators

ChatGPT
Use this when the user wants to share a Grocer list with a specific person, before creating an invite link. Returns the people the user already shares lists with directly (members of lists they own, and owners of lists they are on), with the number of lists they share. Anyone listed can be added to another list the user owns with add_grocery_list_collaborator, without a link. Match the person by name; if nobody matches, or the match is unclear, use share_grocery_list instead.

list_grocery_list_members

ChatGPT
Use this when the user asks who is on, or has access to, a specific Grocer list. Returns the list's members with their names and roles: the owner, editors (who can add, edit and check off items) and viewers (who can only read), oldest first after the owner, and which one is the user. Anyone on the list can see this.

list_grocery_lists

ChatGPT
Use this when the user wants to find or choose one of their active Grocer lists. Includes lists shared with them.

move_item_to_category

ChatGPT
Assign an existing item to a built-in or custom category. A new category name becomes available in the iPhone app when assigned to an item. Identify the exact item first. Viewers cannot move items.

rename_grocery_list

ChatGPT
Use this when the user asks to rename one of their Grocer lists. First identify its ID with list_grocery_lists. Owners and editors can rename a list; viewers cannot. The new name shows for everyone the list is shared with.

set_category_order

ChatGPT
Use this when the user wants a Grocer list's categories in a different order, such as to match the aisles of their store ("produce first, then bakery, frozen last"). First read the list with get_grocery_list and pass its category_order rearranged as the user asked. Categories left out go after the ones given: built-in ones in their usual order, custom ones by name. Set reset to true, without categories, to go back to Grocer's built-in order. Everyone on the list sees the new order in Grocer. Owners and editors can change it; viewers cannot.

set_item_categories

ChatGPT
Use this when the user wants items in a Grocer list sorted into categories, such as "organize my list by aisle" or "sort the uncategorized items", or moves more than one item at once. Prefer it over repeated move_item_to_category calls. First read the list with get_grocery_list. An item whose manual_category is set was already placed by someone, so leave it unless the user asks to change it. Prefer one of Grocer's built-in categories: Produce, Dairy, Meat, Seafood, Bakery, Pantry, Beverages, Frozen, Snacks, Cleaning, Personal Care, Baby Care, Paper Goods, Pharmacy, Pet, Household, Other. Always use these English names, whatever language the user or item is in, so the iPhone groups the item with the rest of that category. Use a new short name only when none fits, and reuse custom names from list_categories rather than creating near-duplicates. Changes up to 100 items in one call; all are changed or none are. Viewers cannot move items.

set_item_completed

ChatGPT
Use this when the user asks to check off or uncheck a specific item in a Grocer list. Viewers cannot change items.

set_items_completed

ChatGPT
Use this when the user checks off or unchecks more than one item in a Grocer list at once, such as "I bought everything in produce" or "got the milk, eggs and bread". Prefer it over repeated set_item_completed calls. First read the list with get_grocery_list and choose the matching item IDs; for a category, use an item's manual_category when it is set and otherwise judge by its title. Changes up to 100 items in one call; all are changed or none are. Viewers cannot change items.

share_grocery_list

ChatGPT
Use this when the user wants to share a Grocer list or invite someone to it. Returns an invite link the user sends themselves; Grocer does not send it. Whoever opens the link within 14 days can join the list in the Grocer iPhone app, installing it from the App Store first if needed. An editor can add, edit and check off items; a viewer can only read. Use editor unless the user asks for read-only access. Owners and editors can share a list; viewers cannot. Each call creates a new link.

whoami

ChatGPT
Use this when the user wants to check which Grocer account is connected.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/grocer"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/grocer)