LystBot

AI grocery list app: shared lists with LystBot

LystBot is an AI grocery list app that lets Claude add ingredients to the shared list on your phone. Log in with npx lystbot login YOUR_API_KEY, then connect its local MCP server with claude mcp add lystbot -- npx lystbot mcp.

Connection Start here Use
Claude Code claude mcp add lystbot -- npx lystbot mcp Save items from a conversation
CLI npx lystbot lists Read your shared lists
REST GET /api/v1/lists Read lists from a script

See the LystBot agent setup for the full reference. Related guides: Claude setup for shared groceries, AI agents saving tasks.

An AI list app with shared lists for families

Before the AI stuff, LystBot handles the daily basics:

LystBot overview of shared household lists Grocery items and checked states in a LystBot list

Share a list by sending a code to your partner. They open it on their phone and see every update live. No account linking, no email invitations. You create a grocery list, your partner checks things off at the store, both phones stay in sync.

You don't need to touch any technical settings to use shared lists. AI connections are optional. Shared list members can keep using the mobile app while an agent adds or checks items through its API key.


An AI shopping list connected to Claude

Tell Claude: "Find me a carbonara recipe and add everything to my grocery list."

After a successful tool call, open LystBot and check the saved ingredients: guanciale, pecorino romano, eggs, black pepper, spaghetti. Your partner's phone has them too, because shared lists update in real time.

Phone notification for items added by an AI agent Share code for inviting someone to a LystBot list

LystBot ships with a built-in MCP server, listed in the official MCP Registry. MCP (Model Context Protocol) is the open standard that lets AI assistants like Claude interact with external tools. When Claude says "Done," LystBot makes it true.

Setup for Claude Desktop (one line in your config):

{"mcpServers":{"lystbot":{"command":"npx","args":["lystbot","mcp"]}}}

Setup for Claude Code:

claude mcp add lystbot -- npx lystbot mcp

Before starting MCP, copy the API key from Settings, then AI Agents, and run npx lystbot login YOUR_API_KEY.

LystBot settings with the AI Agents option

Download LystBot free on the App Store and Google Play and try it with your AI assistant.


CLI and API access for developers

LystBot also exposes a CLI and REST API for automation, AI agents like OpenClaw, and custom integrations.

CLI example:

npx lystbot login YOUR_API_KEY
npx lystbot create "Groceries" --type shopping --emoji "🛒"
npx lystbot add "Groceries" "Milk, Eggs, Bread"
npx lystbot check "Groceries" "Milk"

REST API for anything custom. The API docs cover all endpoints.

The CLI and MCP server are open source on GitHub. Read the code, open issues, contribute.


FAQ

Does my household need an AI assistant?

No. Other members can use the mobile app to read and check the shared list. The assistant is another way to change that same list.

How does Claude save groceries?

Claude uses the local MCP server, which has 26 documented tools. After login, register it with claude mcp add lystbot -- npx lystbot mcp and ask it to read your lists first.

Can I use ChatGPT?

ChatGPT integration is coming soon. The current local MCP setup is documented for clients such as Claude Desktop and Claude Code.