Server data from the Official MCP Registry
Let your AI manage your real grocery list — unofficial Listonic MCP server
About
Let your AI manage your real grocery list — unofficial Listonic MCP server
Security Report
This is a well-structured MCP server with appropriate authentication, reasonable permission scope, and clean code practices. Credentials are properly handled via environment variables, and the server only communicates with the Listonic API. Minor code quality findings around broad exception handling and lack of input validation on list_id do not significantly impact security. Supply chain analysis found 12 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.
4 files analyzed · 16 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: LISTONIC_EMAIL
Environment variable: LISTONIC_PASSWORD
Environment variable: LISTONIC_LIST_ID
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-arturlys-listonic-mcp": {
"env": {
"LISTONIC_EMAIL": "your-listonic-email-here",
"LISTONIC_LIST_ID": "your-listonic-list-id-here",
"LISTONIC_PASSWORD": "your-listonic-password-here"
},
"args": [
"listonic-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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 mcp add listonic -e LISTONIC_EMAIL=you@example.com -e LISTONIC_PASSWORD=your-password -- listonic-mcp
Cursor Settings → MCP → New MCP Server, paste the JSON config above.
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
| Param | Env var | Default | What it does |
|---|---|---|---|
--email | LISTONIC_EMAIL | — | Listonic account email (required). |
--password | LISTONIC_PASSWORD | — | Listonic account password (required). |
--list-id | LISTONIC_LIST_ID | first list | Pin a default list; see get_lists for the ids. |
Tools
| Tool | What it does |
|---|---|
get_lists | All your shopping lists with their ids. |
get_items | Items on a list — checked (already have) vs unchecked (to buy). |
add_items | Add one or many items in a single call (name, quantity, unit). |
edit_items | Check/uncheck, rename, or re-quantity items — batched. |
delete_items | Remove 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.comdirectly 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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption