
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
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.
Installation
In SourceWeft
- Open Lystbot in the dashboard and add it to a workspace.
- 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
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):
Cursor / Devin Desktop
Add this to .cursor/mcp.json (Cursor) or ~/.config/devin/mcp_config.json (Devin Desktop, formerly Windsurf):
Setup
- Install the app: lystbot.com
- Copy your API key from Settings → AI Agents
- Run
npx lystbot login <your-api-key> - Add the MCP config above
- Ask Claude: "What's on my grocery list?"
Available tools
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
0Version history
2- v0.4.1LatestOct 29, 2026
- 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