English Français العربية

io.github.ArturLys/listonic-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

Let your AI manage your real grocery list — unofficial Listonic MCP server

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package listonic-mcp
Claude Code 
claude mcp add listonic-mcp -e 'LISTONIC_EMAIL=<LISTONIC_EMAIL>' -e 'LISTONIC_PASSWORD=<your listonic_password>' -e 'LISTONIC_LIST_ID=<LISTONIC_LIST_ID>' -- uvx listonic-mcp==0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "listonic-mcp": {
            "command": "uvx",
            "args": [
                "listonic-mcp==0.1.0"
            ],
            "env": {
                "LISTONIC_EMAIL": "<LISTONIC_EMAIL>",
                "LISTONIC_PASSWORD": "<your listonic_password>",
                "LISTONIC_LIST_ID": "<LISTONIC_LIST_ID>"
            }
        }
    }
}

متغيرات البيئة

  • LISTONIC_EMAIL إلزامي Listonic account email
  • LISTONIC_PASSWORD إلزامي سري Listonic account password
  • LISTONIC_LIST_ID Optional: pin a default list id (otherwise the account's first list is used)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. listonic-mcp
  2. Install
  3. Add to your agent
  4. Tools
  5. Good to know
  6. Make it yours
  7. Credits
  8. License

listonic-mcp

An MCP (Model Context Protocol) server that gives AI agents — Claude, Cursor, or any MCP client — hands on your real Listonic grocery list. Read it, add to it, check things off, across every device Listonic syncs to.

The obvious win: meal planning that ends in a shopping list. Ask your agent to plan the week's dinners, and the missing ingredients land straight on the list on your phone — quantities and all. Or paste a recipe and say "add what I don't have": the server tells the agent which items are checked (already at home) and which aren't.

You:   plan me 3 cheap high-protein dinners and put the ingredients on my list
Agent: [reads your list — sees you already have rice, eggs, frozen spinach]
       [adds: 1 kg chicken thighs, 400 g lentils, greek yogurt ×2, ...]

Unofficial. Not affiliated with Listonic. Built on their web app's API (reverse-engineered — fully documented in API.md). It may break if Listonic changes their API.

Install

Requires Python 3.10+ and a Listonic account (free):

pip install listonic-mcp

Add to your agent

Point command at listonic-mcp and pass your Listonic login:

{
  "mcpServers": {
    "listonic": {
      "command": "listonic-mcp",
      "env": {
        "LISTONIC_EMAIL": "you@example.com",
        "LISTONIC_PASSWORD": "your-listonic-password"
      }
    }
  }
}

The same values can be passed as --email / --password args instead — whichever your client makes easier.

Claude Code

claude mcp add listonic -e LISTONIC_EMAIL=you@example.com -e LISTONIC_PASSWORD=your-password -- listonic-mcp

Cursor

Cursor Settings → MCP → New MCP Server, paste the JSON config above.

Google Antigravity

Add the JSON config above to .gemini/antigravity/mcp_config.json.

Then just ask:

What's on my grocery list? Check off the milk, I just bought it.
Launch params
ParamEnv varDefaultWhat it does
--emailLISTONIC_EMAIL—Listonic account email (required).
--passwordLISTONIC_PASSWORD—Listonic account password (required).
--list-idLISTONIC_LIST_IDfirst listPin a default list; see get_lists for the ids.

Tools

ToolWhat it does
get_listsAll your shopping lists with their ids.
get_itemsItems on a list — checked (already have) vs unchecked (to buy).
add_itemsAdd one or many items in a single call (name, quantity, unit).
edit_itemsCheck/uncheck, rename, or re-quantity items — batched.
delete_itemsRemove items entirely.

Every tool takes an optional list_id, so multiple lists ("weekend BBQ", "pharmacy") work naturally.

Good to know

  • Your password goes to Listonic only. The server logs in against api.listonic.com directly and talks to nothing else — no telemetry, nothing stored beyond an in-memory session token (auto-refreshed when it expires).
  • The client id/secret in the source are Listonic's own web-app credentials, embedded in their public JS bundle and shared by every web user — they are not personal secrets.
  • The full reverse-engineered API is documented in API.md — lists, items, categories, account endpoints — if you want to extend the server.

Make it yours

A single readable file with no framework magic. Fork it and edit anything — add price tracking, category sorting, a recipe parser. Run from source:

git clone https://github.com/ArturLys/listonic-mcp.git
cd listonic-mcp
pip install -e .
listonic-mcp --email you@example.com --password your-password

Credits

  • Listonic — the shopping list app this talks to. Go pay them for premium if you live off it.

License

MIT

الأسئلة الشائعة

ما هو io.github.ArturLys/listonic-mcp؟

Let your AI manage your real grocery list — unofficial Listonic MCP server

كيف أثبّت io.github.ArturLys/listonic-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add listonic-mcp -e 'LISTONIC_EMAIL=<LISTONIC_EMAIL>' -e 'LISTONIC_PASSWORD=<your listonic_password>' -e 'LISTONIC_LIST_ID=<LISTONIC_LIST_ID>' -- uvx listonic-mcp==0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ArturLys/listonic-mcp إلى مفتاح API؟

نعم. يتطلب LISTONIC_EMAIL, LISTONIC_PASSWORD، وتضبطها في إعداداته.

هل io.github.ArturLys/listonic-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ArturLys/listonic-mcp؟

ينشره ArturLys. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.