Lystbot

io.github.TourAround由 GitHub 账号 TourAround 发布v0.4.1更新于 Oct 29, 2026

Smart lists and reminders your AI can use. Manage lists, categories, and reminders via MCP.

已验证STDIO仅桌面效率与工作流文件与存储

概览

AI 生成的概览

Lystbot 让 AI 助手连接你的 Lystbot 智能清单与提醒,可添加、勾选、分类整理条目并设置提醒。

可以做什么
  • 清单管理:查看全部清单、读取清单及其条目、创建、删除、分享和加入清单
  • 条目管理:用自然语句或结构化的数量与单位添加条目,勾选、取消勾选、删除条目,清除已完成条目
  • 分类整理:列出、创建、重命名、删除和重排分类,并在分类之间移动条目
  • 附件:为条目附加图片或链接,查看并删除附件
  • 提醒:列出、查看、创建、更新和删除带时间与时区的提醒
适用场景
适合把购物、打包或待办清单放在 Lystbot 中,并希望通过对话让助手更新清单的场景,例如询问清单内容或一次添加多个条目。也适合在清单之外安排提醒。
运行要求
通过 npx(Node.js)以 stdio 本地进程运行。需要 Lystbot 账号和桌面应用,并在配置客户端前用登录命令保存一次从设置 → AI Agents 复制的 API 密钥。
安装前请注意
该 API 密钥可访问你的清单和提醒,请妥善保管。服务器可创建、修改和删除清单、条目、分类、附件与提醒,并可生成让他人加入清单的分享码。附加的图片和链接会随条目一并保存。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Lystbot,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

LystBot CLI & MCP server

Smart lists and reminders that your AI can actually use.

CLI

bash
npx lystbot login <your-api-key>npx lystbot listsnpx lystbot add "Groceries" "Milk, Eggs, Butter"npx lystbot add "Groceries" "250g Mehl; 3x Milch; 3 Bananen; 2 Flaschen Wein"npx lystbot add "Groceries" "Mehl" --quantity 2 --unit "500g"npx lystbot check "Groceries" "Milk"
# Categoriesnpx lystbot categories "Groceries"npx lystbot category add "Groceries" "Fruits"npx lystbot add "Groceries" "Bananas" --category "Fruits"npx lystbot move "Groceries" "Bananas" --category other
# Attachmentsnpx lystbot attach-image "Groceries" "Milk" ./photo.jpgnpx lystbot attach-url "Groceries" "Milk" "https://example.com" "Recipe"npx lystbot attachments "Groceries" "Milk"npx lystbot detach <attachment-id>
# Remindersnpx lystbot remindersnpx lystbot reminder <id>npx lystbot remind "Take vitamins" --at "tomorrow 09:00" --timezone "Europe/Berlin"npx lystbot reminder-update <id> --title "Take supplements"npx lystbot reminder-update <id> --at "tomorrow 09:00" --enablednpx lystbot reminder-update <id> --disablednpx lystbot reminder-delete <id> --yes

The CLI turns natural prefixes into structured fields. 250g Mehl becomes text Mehl with quantity 1 and unit 250g. 3x Milch and 3 Bananen get quantity 3. 2 Flaschen Wein gets unit 2 Flaschen. Separate items with , or ;. --quantity takes a whole number from 1 to 99, and --quantity and --unit only work when you add a single item.

MCP server (Claude Desktop, Cursor, Devin Desktop)

The CLI includes an MCP server. After login, configure your client to run npx with args ["lystbot", "mcp"] (npx lystbot mcp):

Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor / Devin Desktop

Add this to .cursor/mcp.json (Cursor) or ~/.config/devin/mcp_config.json (Devin Desktop, formerly Windsurf):

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

Setup

  1. Install the app: lystbot.com
  2. Copy your API key from Settings → AI Agents
  3. Run npx lystbot login <your-api-key>
  4. Add the MCP config above
  5. Ask Claude: "What's on my grocery list?"

Available tools

ToolDescription
list_listsGet all your lists
get_listGet a list with all items
create_listCreate a new list
delete_listDelete a list
add_itemsAdd natural-syntax strings or structured {text, quantity?, unit?} items
check_itemCheck off an item
uncheck_itemReopen a checked item
remove_itemDelete an item
clear_checkedRemove all checked (completed) items from a list
share_listGenerate a share code
join_listJoin a shared list
list_categoriesList categories for a list
create_categoryCreate a category
rename_categoryRename a category
delete_categoryDelete a category
reorder_categoriesReorder categories
move_itemMove an item to a category (or Other)
add_item_imageAttach an image to an item (image_path, or image_base64 + mime_type + filename)
add_item_urlAttach an http(s) link to an item
list_item_attachmentsList all attachments of an item
delete_item_attachmentDelete an attachment by ID
list_remindersGet all reminders
get_reminderGet one reminder
create_reminderCreate a reminder
update_reminderUpdate a reminder
delete_reminderDelete a reminder

Natural strings such as 3 Bananen become quantity 3 with unit null. For precise calls, add_items also accepts structured input such as [{"text":"Mehl","quantity":2,"unit":"500g"}]. Weight is a unit: 250g means quantity 1 and unit 250g, never quantity 250.

Documentation

Full docs are at lystbot.com and in docs/.

来源:cli/README.md,提交 8933697

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

2
  1. v0.4.1最新Oct 29, 2026
  2. v0.4.0Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分