• LIST UPDATE
  • LIST VIEW
  • CLEANUP
  • HUMAN ACTION

How to manage shopping lists with your AI

Connect Grocy to your AI client to handle your grocery needs through conversation. You'll stop toggling between apps just to add a single item.

Ask AI about this page

Short answer

Can I use my AI to update my Grocy shopping list?

Yes. You can add new items, view your current list, and remove things you've already picked up. Here is how the data moves between your chat and Grocy.

Where every update lands.

The outcomes of your commands

Your AI acts as the bridge between your chat window and your Grocy database.

LIST UPDATE

New items added

When you tell your AI you need something, it adds that item directly to your Grocy shopping list.

LIST VIEW

Current list status

Your AI pulls the latest data from Grocy so you can see exactly what you need to buy right now.

CLEANUP

Items removed

Once you're at the store, you can tell your AI to clear out the things you've already put in your cart.

HUMAN ACTION

Manual Grocy edits

If you need to change product quantities or edit specific Grocy settings, you'll still use the Grocy interface directly.

The workflow

What your AI does when you ask for list help.

The AI translates your natural language into specific Grocy database actions.

  1. Adding items

    When you mention a missing ingredient, the AI sends that specific item to your Grocy list.

    add_shopping_list_item

  2. Checking inventory

    The AI reads your current list so you can ask what you're missing for a recipe.

    get_shopping_list

  3. Clearing items

    After you buy something, the AI marks it as finished by removing it from the list.

    remove_purchased_shopping_list

  4. Resetting the list

    If you want to start fresh, the AI can wipe the entire shopping list at once.

    clear_shopping_list

Try it

Copy these to start.

Use these prompts to test the connection immediately.

Starting points

Swap out the bracketed text for your actual grocery items or specific needs.

Grocy Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Grocy capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "grocy-home-erp-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp"
    }
  }
}
Copy into chat04

  • Add milk and eggs to my Grocy shopping list.

  • What is currently on my Grocy shopping list?

  • I bought the bread, please remove it from my shopping list.

  • Clear my entire Grocy shopping list.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Grocy once, then ask.

You only need to link your Grocy instance one time. Your credentials stay encrypted, and you can start chatting with your list immediately.

Connect Grocy to your AI

FAQ

How the Grocy task behaves

  • 01

    Can the AI add items to my pantry inventory?

    No. This specific task is limited to managing the shopping list.

  • 02

    Will the AI delete my entire Grocy database?

    No. The AI only has permission to clear the shopping list, not your entire inventory or settings.

  • 03

    Can I use this with any AI client?

    Yes, as long as the client supports the Model Context Protocol (MCP).

  • 04

    Does the AI know my Grocy password?

    No. Your login details are handled securely and are not visible to the AI model.

  • 05

    Can the AI change the names of my products?

    No. The AI can only add, view, or remove items from the list.

  • More questions about Grocy? The Connector page answers them. See everything the Grocy Connector can do

Connect Grocy to Claude, Cursor, ChatGPT & more