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 分