Lystbot

io.github.TourAroundPublished by GitHub account TourAroundv0.4.1Updated Oct 29, 2026

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

Overview

AI-generated overview

Lystbot connects an AI assistant to your Lystbot smart lists and reminders so it can add, check off, organize and schedule items.

What you can do
  • List and manage lists: view all lists, read a list with its items, create, delete, share and join lists
  • Manage items: add items from natural phrases or structured quantity/unit values, check off, reopen, remove, clear completed items
  • Organize with categories: list, create, rename, delete and reorder categories, and move items between them
  • Attach images and links to items, list attachments and delete them
  • Handle reminders: list, read, create, update and delete reminders with times and timezones
When to use it
Useful when you keep shopping, packing or task lists in Lystbot and want an assistant to update them by conversation, for example asking what is on a list or adding several items at once. Also fits scheduling reminders alongside those lists.
Requirements
Runs locally via npx (Node.js) as a stdio process. Requires a Lystbot account and the desktop app, plus an API key copied from Settings → AI Agents and stored once with the login command before configuring the client.
Before you install
The API key grants access to your lists and reminders; keep it private. The server can create, change and delete lists, items, categories, attachments and reminders, and can generate share codes that let others join a list. Attached images and links are stored with the items.

Installation

In SourceWeft

  1. Open Lystbot in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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/.

Source: cli/README.md at commit 8933697

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.4.1LatestOct 29, 2026
  2. v0.4.0Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts