🚀 Getting started
1. Get the app
Open the app, create your first list, and grab your API key from Settings → AI Agents.
🖥️ Use it in your browser
app.lystbot.com: all your lists on desktop. Pair it with a code from the app, no account required.
Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add io.github.touraround-lystbot -- npx -y lystbot@0.4.1In einem Terminal ausführen.
{ "mcpServers": { "io.github.touraround-lystbot": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
Open the app, create your first list, and grab your API key from Settings → AI Agents.
app.lystbot.com: all your lists on desktop. Pair it with a code from the app, no account required.
Smart lists and reminders your AI can use. Manage lists, categories, and reminders via MCP.
👉 Just curious? Try the demo: runs fully in your browser, nothing is stored.
The agent setup page has step-by-step instructions:
There are three ways to connect:
npx lystbot login YOUR_API_KEY
npx lystbot add "Groceries" "Oat milk, Bananas, Coffee"
The items show up in the app right away.
Most "AI list apps" put a chatbot inside the app. LystBot does the opposite: you keep using the AI you already have, and it controls LystBot from the outside.
You → talk to your AI → AI calls LystBot API → your phone updates instantly
There's no new AI to learn and no prompting inside the app. Connect your existing AI and let it manage groceries, packing lists, todos and reminders.
LystBot works with any AI that can make HTTP requests. Here's how to connect yours:
Don't see your agent? If it can call an API, it can use LystBot. Check the API docs.
The LystBot CLI manages your lists from the terminal. It's built for AI agents like OpenClaw that work best with command-line tools, and for anyone who likes to script things.
npm install -g lystbot
lystbot login <YOUR_API_KEY>
Without a global install, prefix every command with npx, for example npx lystbot lists.
# Lists
lystbot lists # Show all lists
lystbot show "Groceries" # Show a list with items
lystbot create "Packing List" --emoji "🧳" # Create a new list
lystbot delete "Old List" --force # Delete a list
# Items
lystbot add "Groceries" "Milk, Eggs, Bread" # Add items (comma-separated)
lystbot add "Groceries" "250g Mehl; 3x Milch; 3 Bananen" # Parse unit and count prefixes
lystbot add "Groceries" "Mehl" --quantity 2 --unit "500g" # Explicit fields
lystbot check "Groceries" "Milk" # Check off an item
lystbot uncheck "Groceries" "Milk" # Uncheck an item
lystbot remove "Groceries" "Milk" # Remove an item
# Attachments
lystbot attach-image "Groceries" "Milk" ./photo.jpg # Attach a local image
lystbot attach-url "Groceries" "Milk" "https://example.com" "Recipe" # Attach a link
lystbot attachments "Groceries" "Milk" # Show attachments
lystbot detach <attachment-id> # Delete an attachment
# Categories
lystbot categories "Groceries" # List categories (incl. Other)
lystbot category add "Groceries" "Fruits" # Create a category
lystbot add "Groceries" "Bananas" --category "Fruits" # Add into a category
lystbot move "Groceries" "Bananas" --category other # Move to Other/uncategorized
# Reminders
lystbot reminders # Show all reminders
lystbot reminder <id> # Show one reminder
lystbot remind "Take vitamins" --at "2026-05-08 09:00" --timezone "Europe/Berlin"
lystbot reminder-update <id> --title "Take supplements"
lystbot reminder-update <id> --at "2026-05-09 09:00" --enabled
lystbot reminder-update <id> --disabled
lystbot reminder-delete <id> --yes
# Sharing
lystbot share "Groceries" # Generate a share code
lystbot join ABC123 # Join a shared list
# Agent identity
lystbot profile --name "TARS" --emoji "🤖" # Set your bot's display name
Full reference: CLI docs
The CLI includes an MCP server. It runs locally over stdio, so it works with Claude Desktop, Claude Code, Codex, Cursor, Devin Desktop, Grok Build, Antigravity, Cline and any other MCP client that can start a local server.
For Cline, see the installation guide.
Log in first. Every setup below needs this:
npx lystbot login <YOUR_API_KEY>
Add this to your config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"lystbot": {
"command": "npx",
"args": ["lystbot", "mcp"]
}
}
}
Then restart Claude Desktop.
claude mcp add lystbot -- npx lystbot mcp
Claude Code can now manage your lists.
codex mcp add lystbot -- npx lystbot mcp # Codex
grok mcp add lystbot -- npx lystbot mcp # Grok Build
Add the same config to the tool's MCP settings. For Cursor that's .cursor/mcp.json, for Devin Desktop ~/.config/devin/mcp_config.json and for Antigravity ~/.gemini/config/mcp_config.json. Cline has its own MCP settings screen.
{
"mcpServers": {
"lystbot": {
"command": "npx",
"args": ["lystbot", "mcp"]
}
}
}
add_items understands 250g Mehl, 3x Milch, plain counts such as 3 Bananen or 3 bananas, and container forms such as 2 Flaschen Wein. Agents can also send structured items like [{"text":"Mehl","quantity":2,"unit":"500g"}]. Weights go into unit, so 250 g of flour is "unit":"250g", not "quantity":250.
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Your Phone │ │ Your AI │ │ MCP Client │ │ CLI │
│ (LystBot │ │ (OpenClaw, │ │ (Claude, │ │ (npx │
│ App) │ │ ChatGPT) │ │ Cursor) │ │ lystbot) │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘
│ │ │ │
│ X-Device-UUID │ Bearer Token │ MCP via CLI │ Bearer Token
│ │ │ │
└────────┬────────┴────────┬────────┴────────┬────────┘
│ │ │
┌──────▼─────────────────▼─────────────────▼──────┐
│ LystBot API │
│ (REST/JSON) │
└─────────────────────────────────────────────────┘
The MCP server runs locally as lystbot mcp and calls the same REST API with your API key.
npx lystbot mcp (see setup above)Bug reports and feature requests go to Issues. Pull requests for the CLI and the docs are welcome.
MIT - see LICENSE for details.
Built with ❤️ by TourAround UG
Smart lists and reminders your AI can use. Manage lists, categories, and reminders via MCP.
{ "mcpServers": { "io.github.touraround-lystbot": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Lystbot läuft lokal über stdio.
Zuletzt geprüft: 2026-11-09. Smart lists and reminders your AI can use. Manage lists, categories, and reminders via MCP.