lystbot

LystBot CLI と MCP サーバー

AI が実際に使えるスマートリストとリマインダーです。

CLI

npx lystbot login <your-api-key>
npx lystbot lists
npx 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"

# Categories
npx lystbot categories "Groceries"
npx lystbot category add "Groceries" "Fruits"
npx lystbot add "Groceries" "Bananas" --category "Fruits"
npx lystbot move "Groceries" "Bananas" --category other

# Attachments
npx lystbot attach-image "Groceries" "Milk" ./photo.jpg
npx lystbot attach-url "Groceries" "Milk" "https://example.com" "Recipe"
npx lystbot attachments "Groceries" "Milk"
npx lystbot detach <attachment-id>

# Reminders
npx lystbot reminders
npx lystbot reminder <id>
npx lystbot remind "Take vitamins" --at "2026-05-08 09:00" --timezone "Europe/Berlin"
npx lystbot reminder-update <id> --title "Take supplements"
npx lystbot reminder-update <id> --at "2026-05-09 09:00" --enabled
npx lystbot reminder-update <id> --disabled
npx lystbot reminder-delete <id> --yes

CLI は自然な接頭辞を構造化フィールドに変換します。250g Mehl は、テキストが Mehl、数量が 1、単位が 250g になります。3x Milch と 3 Bananen は数量が 3 になります。2 Flaschen Wein は単位が 2 Flaschen になります。アイテムは , または ; で区切ります。--quantity には 1〜99 の整数を指定します。また、--quantity と --unit はアイテムを 1 つだけ追加するときに限り使用できます。

MCP サーバー（Claude Desktop、Cursor、Devin Desktop）

CLI には MCP サーバーが含まれています。お使いの AI ツールに追加してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に次を追加します。

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

Cursor / Devin Desktop

.cursor/mcp.json（Cursor）または ~/.config/devin/mcp_config.json（Devin Desktop、旧 Windsurf）に次を追加します。

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

セットアップ

1. アプリをインストールします：lystbot.com
2. Settings → AI Agents から API キーをコピーします
3. npx lystbot login <your-api-key> を実行します
4. 上記の MCP 設定を追加します
5. Claude に「買い物リストには何がありますか？」と尋ねます

利用可能なツール

ツール	説明
list_lists	すべてのリストを取得
get_list	すべてのアイテムを含むリストを取得
create_list	新しいリストを作成
delete_list	リストを削除
add_items	自然な構文の文字列、または構造化された {text, quantity?, unit?} アイテムを追加
check_item	アイテムにチェックを付ける
uncheck_item	チェック済みのアイテムを未チェックに戻す
remove_item	アイテムを削除
clear_checked	リストからチェック済み（完了済み）のアイテムをすべて削除
share_list	共有コードを生成
join_list	共有リストに参加
list_categories	リストのカテゴリーを一覧表示
create_category	カテゴリーを作成
rename_category	カテゴリー名を変更
delete_category	カテゴリーを削除
reorder_categories	カテゴリーの順序を変更
move_item	アイテムをカテゴリー（または「その他」）に移動
add_item_image	アイテムに画像を添付（image_path、または image_base64 + mime_type + filename）
add_item_url	アイテムに http(s) リンクを添付
list_item_attachments	アイテムの添付ファイルをすべて一覧表示
delete_item_attachment	ID を指定して添付ファイルを削除
list_reminders	すべてのリマインダーを取得
get_reminder	1 件のリマインダーを取得
create_reminder	リマインダーを作成
update_reminder	リマインダーを更新
delete_reminder	リマインダーを削除

3 Bananen のような自然な文字列は、数量 3、単位 null に変換されます。正確に指定する場合、add_items は [{"text":"Mehl","quantity":2,"unit":"500g"}] のような構造化入力も受け付けます。重量は単位です。250g は数量 1、単位 250g を意味し、数量 250 にはなりません。

ドキュメント

詳細なドキュメントは lystbot.com と docs/ にあります。