mcpField
L
listonic-mcp

listonic-mcp

本地服务
github.com/ArturLys生产力013 周前更新
代码仓库

关于 listonic-mcp

listonic-mcp 是非官方 MCP 服务，可让 AI Agent 读取和编辑用户的 Listonic 购物清单。它支持多个清单和商品数量，并直接使用 Listonic Web 应用的 API。

主要功能

  1. 01列出购物清单
  2. 02读取已勾选和未勾选商品
  3. 03添加带数量和单位的商品
  4. 04编辑、勾选或重命名商品
  5. 05删除清单商品

适用场景

  1. 01将膳食计划转为购物清单
  2. 02购物后勾选已购买商品
  3. 03更新多个清单中的商品数量

MCP 相关

通过 MCP 工具向 AI 客户端提供 Listonic 清单和商品操作，并使用用户的 Listonic 账户凭据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "arturlys-listonic": {
      "command": "uvx",
      "args": [
        "listonic-mcp"
      ],
      "env": {
        "LISTONIC_EMAIL": "<LISTONIC_EMAIL>",
        "LISTONIC_PASSWORD": "<LISTONIC_PASSWORD>",
        "LISTONIC_LIST_ID": "<LISTONIC_LIST_ID>"
      }
    }
  }
}
启动命令uvx listonic-mcp
需要配置的环境变量
LISTONIC_EMAILListonic account email
LISTONIC_PASSWORD密钥Listonic account password
LISTONIC_LIST_IDOptional: pin a default list id (otherwise the account's first list is used)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypilistonic-mcp0.1.0

工具

5

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

listonic-mcp

PyPI CI Python 3.10+ License: MIT

一个 MCP（Model Context Protocol）服务，让 AI Agent——Claude、Cursor 或任何 MCP 客户端——能够直接操作你真实的 Listonic 购物清单。你可以读取清单、添加商品、勾选商品，所有更改都会同步到 Listonic 同步的每台设备上。

显而易见的优势：**让膳食规划最终变成购物清单。**让你的 Agent 规划本周晚餐，缺少的食材就会直接出现在手机上的清单中——数量也一并列出。也可以粘贴食谱并说“添加我没有的东西”：服务会告诉 Agent 哪些商品已勾选（家里已有），哪些还没有。

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, ...]

**非官方项目。**与 Listonic 无关。此项目基于其 Web 应用的 API 构建（通过逆向工程分析，完整文档见 API.md）。如果 Listonic 更改 API，此项目可能会失效。

安装

需要 Python 3.10+ 和 Listonic 账户（免费）：

pip install listonic-mcp

添加到你的 Agent

将 command 指向 listonic-mcp，并传入你的 Listonic 登录信息：

{
  "mcpServers": {
    "listonic": {
      "command": "listonic-mcp",
      "env": {
        "LISTONIC_EMAIL": "[email protected]",
        "LISTONIC_PASSWORD": "your-listonic-password"
      }
    }
  }
}

也可以通过 --email / --password 参数传入相同的值——选择客户端更方便的方式即可。

Claude Code 
claude mcp add listonic -e [email protected] -e LISTONIC_PASSWORD=your-password -- listonic-mcp
Cursor

Cursor Settings → MCP → New MCP Server，粘贴上面的 JSON 配置。

Google Antigravity

将上面的 JSON 配置添加到 .gemini/antigravity/mcp_config.json。

然后直接提出请求：

What's on my grocery list? Check off the milk, I just bought it.
启动参数
参数环境变量默认值功能
--emailLISTONIC_EMAIL—Listonic 账户邮箱（必填）。
--passwordLISTONIC_PASSWORD—Listonic 账户密码（必填）。
--list-idLISTONIC_LIST_ID第一个清单固定默认清单；清单 ID 见 get_lists。

工具

工具功能
get_lists获取你的所有购物清单及其 ID。
get_items获取清单中的商品——已勾选（已有）与未勾选（待购买）。
add_items一次调用添加一个或多个商品（名称、数量、单位）。
edit_items批量勾选/取消勾选、重命名或更改商品数量。
delete_items完全移除商品。

每个工具都可以使用可选的 list_id，因此可以轻松操作多个清单（“周末烧烤”“药房”）。

注意事项

  • **你的密码只会发送给 Listonic。**服务会直接登录 api.listonic.com，不会与其他任何对象通信——没有遥测，也不会在内存会话令牌之外存储任何内容（令牌过期时会自动刷新）。
  • 源代码中的客户端 ID/密钥是 Listonic 自己的 Web 应用凭据，嵌入在其公开的 JS 包中，并由所有 Web 用户共用——它们不是个人机密。
  • 完整的逆向工程 API 文档见 API.md，涵盖清单、商品、类别和账户端点；你可以据此扩展服务。

按需定制

这是一个易读的单文件项目，没有框架魔法。你可以 Fork 并随意修改——添加价格追踪、类别排序或食谱解析器。从源代码运行：

git clone https://github.com/ArturLys/listonic-mcp.git
cd listonic-mcp
pip install -e .
listonic-mcp --email [email protected] --password your-password

致谢

  • Listonic — 本项目连接的购物清单应用。如果你靠它过日子，就付费订阅高级版吧。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。