{
  "markdown": "<p align=\"center\">\n  <img src=\"./assets/lystbot-logo-with-icon.png\" alt=\"LystBot\" width=\"320\" />\n</p>\n\n<h3 align=\"center\">Smart lists and reminders that your AI can actually use.</h3>\n\n<p align=\"center\">\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"MIT License\" /></a>\n  <a href=\"https://www.npmjs.com/package/lystbot\"><img src=\"https://img.shields.io/npm/v/lystbot.svg\" alt=\"npm\" /></a>\n  <a href=\"https://lystbot.com/api/v1/health\"><img src=\"https://img.shields.io/badge/API-online-brightgreen.svg\" alt=\"API Status\" /></a>\n</p>\n\n<p align=\"center\">\n  <strong>LystBot is not another AI list app.</strong> There's no built-in AI. No chatbot. No \"AI-powered suggestions.\"<br />\n  Instead, LystBot gives <em>your</em> AI - whether it's OpenClaw, Hermes, Claude Code, ChatGPT, Copilot, Grok Bot, or another agent - a direct line to your lists and reminders.<br />\n  <strong>Your AI controls the lists and reminders. The app is the window to the real world.</strong>\n</p>\n\n---\n\n## 🚀 Getting Started\n\n### 1. Get the App\n\n<p align=\"center\">\n  <a href=\"https://apps.apple.com/app/lystbot/id6742044832\"><img src=\"https://img.shields.io/badge/App_Store-Download-blue?logo=apple&logoColor=white&style=for-the-badge\" alt=\"App Store\" /></a>\n  &nbsp;&nbsp;\n  <a href=\"https://play.google.com/store/apps/details?id=io.touraround.lystbot\"><img src=\"https://img.shields.io/badge/Google_Play-Download-green?logo=googleplay&logoColor=white&style=for-the-badge\" alt=\"Google Play\" /></a>\n</p>\n\nOpen the app, create your first list, and grab your API key from **Settings → AI Agents**.\n\n### 2. Connect Your AI Agent\n\nHead over to the agent setup page for step-by-step instructions:\n\n👉 **[lystbot.com/agents](https://lystbot.com/agents)**\n\nThree ways to connect, depending on your setup:\n\n| Method | Best for | Setup time |\n|--------|----------|------------|\n| **CLI** | OpenClaw, personal agents, scripts, automation | 1 min |\n| **MCP Server** | Claude Desktop, Cursor, Windsurf, Cline | 2 min |\n| **REST API** | ChatGPT Actions, custom agents, Home Assistant | 5 min |\n\n### 3. That's it\n\n```bash\nnpx lystbot login YOUR_API_KEY\nlystbot add \"Groceries\" \"Oat milk, Bananas, Coffee\"\n```\n\nYour agent adds items. Your phone updates instantly. Done.\n\n---\n\n## 🧠 How It Works\n\nMost \"AI list apps\" shove a chatbot inside the app. LystBot does the opposite: **your AI lives where it already lives**, and LystBot is the app it controls.\n\n```\nYou → talk to your AI → AI calls LystBot API → your phone updates instantly\n```\n\nNo new AI to learn. No prompts inside the app. Just connect your existing AI and it manages your groceries, packing lists, todos, reminders - anything.\n\n- 🤖 **\"Add eggs to my shopping list\" actually works** - from any AI you already use\n- 📱 **Your phone is the display** - your AI writes, you see it instantly\n- 🔑 **Clean separation** - the app is for humans, the API is for agents\n- 🔄 **Real-time sync** - your AI adds milk, your partner sees it immediately\n\n---\n\n## ✨ Features\n\n🗒️ **Smart Lists** - Create, organize, and share lists with anyone\n\n🤝 **Real-time Sharing** - Invite others via share codes, collaborate live\n\n📱 **Cross-Platform** - iOS and Android, with CLI and API access\n\n⭐ **Favorites** - Quick-access items you use all the time\n\n🗂️ **Categories** - Structure lists into sections, move items between categories, keep uncategorized items in Other\n\n📎 **Attachments** - Attach images and links to items, from the app, the CLI, or an MCP agent\n\n⏰ **Reminders** - Let your AI create, update, disable, and delete one-time or recurring reminders\n\n🔔 **Push Notifications** - Know when your AI or your family changes a list\n\n🌐 **Open API** - Full REST API so any AI agent can read, write, and manage lists, categories, and reminders\n\n<p align=\"center\">\n  <img src=\"./assets/app-screenshot-dashboard.png\" alt=\"Dashboard\" width=\"220\" />\n  &nbsp;&nbsp;\n  <img src=\"./assets/app-screnshot-list-detail.png\" alt=\"List Detail\" width=\"220\" />\n  &nbsp;&nbsp;\n  <img src=\"./assets/app-screenshot-push-notification.png\" alt=\"Push Notifications\" width=\"220\" />\n</p>\n\n---\n\n## 🤖 Agent Integrations\n\nLystBot works with any AI that can make HTTP requests. Here's how to connect yours:\n\n### Personal Agents & Autonomous Frameworks\n\n| Agent | Provider | Integration |\n|-------|----------|-------------|\n| **OpenClaw** | OpenClaw | **CLI** (`npx lystbot`) |\n| **Hermes** | [Nous Research](https://hermes-agent.nousresearch.com/) | CLI or REST API |\n| Devin | Cognition AI | CLI or REST API |\n| Aider | Open Source | CLI |\n| OpenCode | Open Source | CLI or MCP Server |\n| AutoGPT | Open Source | REST API |\n| CrewAI | Open Source | REST API |\n| Manus AI | Manus | REST API |\n\n### Coding Agents & IDEs\n\n| Agent | Provider | Integration |\n|-------|----------|-------------|\n| Claude Desktop | Anthropic | MCP Server ([setup below](#claude-desktop)) |\n| Claude Code | Anthropic | MCP Server ([setup below](#claude-code)) |\n| Cursor | Anysphere | MCP Server |\n| Windsurf | Codeium | MCP Server |\n| GitHub Copilot | Microsoft | MCP Server or Copilot Extension |\n| Cline | Open Source | MCP Server |\n\n### Voice Assistants & Chat AI\n\n| Agent | Provider | Integration |\n|-------|----------|-------------|\n| ChatGPT | OpenAI | Custom GPT with OpenAPI Actions |\n| Google Gemini | Google | Gemini Extensions via REST API |\n| Microsoft Copilot | Microsoft | Copilot Plugin with OpenAPI |\n| Grok | xAI | REST API |\n| Siri / Apple Intelligence | Apple | Apple Shortcuts with REST API |\n| Amazon Alexa | Amazon | Custom Alexa Skill with REST API |\n| Google Home | Google | Google Actions with REST API |\n\n> Don't see your agent? If it can call an API, it can use LystBot. Check the [API docs](./docs/api/).\n\n---\n\n## 💻 CLI\n\nThe LystBot CLI lets you manage lists from the terminal. Built for AI agents like **OpenClaw** that work best with command-line tools, and for anyone who likes to script things.\n\n### Install & Login\n\n```bash\nnpx lystbot login <YOUR_API_KEY>\n```\n\n### Commands\n\n```bash\n# Lists\nlystbot lists                              # Show all lists\nlystbot show \"Groceries\"                   # Show a list with items\nlystbot create \"Packing List\" --emoji \"🧳\" # Create a new list\nlystbot delete \"Old List\" --force          # Delete a list\n\n# Items\nlystbot add \"Groceries\" \"Milk, Eggs, Bread\"  # Add items (comma-separated)\nlystbot add \"Groceries\" \"250g Mehl; 3x Milch; 3 Bananen\" # Parse unit and count prefixes\nlystbot add \"Groceries\" \"Mehl\" --quantity 2 --unit \"500g\" # Explicit fields\nlystbot check \"Groceries\" \"Milk\"             # Check off an item\nlystbot uncheck \"Groceries\" \"Milk\"           # Uncheck an item\nlystbot remove \"Groceries\" \"Milk\"            # Remove an item\n\n# Attachments\nlystbot attach-image \"Groceries\" \"Milk\" ./photo.jpg     # Attach a local image\nlystbot attach-url \"Groceries\" \"Milk\" \"https://example.com\" \"Recipe\"  # Attach a link\nlystbot attachments \"Groceries\" \"Milk\"                  # Show attachments\nlystbot detach <attachment-id>                          # Delete an attachment\n\n# Categories\nlystbot categories \"Groceries\"                 # List categories (incl. Other)\nlystbot category add \"Groceries\" \"Fruits\"      # Create a category\nlystbot add \"Groceries\" \"Bananas\" --category \"Fruits\"   # Add into a category\nlystbot move \"Groceries\" \"Bananas\" --category other      # Move to Other/uncategorized\n\n# Reminders\nlystbot reminders                                      # Show all reminders\nlystbot reminder <id>                                  # Show one reminder\nlystbot remind \"Take vitamins\" --at \"2026-05-08 09:00\" --timezone \"Europe/Berlin\"\nlystbot reminder-update <id> --title \"Take supplements\"\nlystbot reminder-update <id> --at \"2026-05-09 09:00\" --enabled\nlystbot reminder-update <id> --disabled\nlystbot reminder-delete <id> --yes\n\n# Sharing\nlystbot share \"Groceries\"                  # Generate a share code\nlystbot join ABC123                        # Join a shared list\n\n# Agent identity\nlystbot profile --name \"TARS\" --emoji \"🤖\" # Set your bot's display name\n```\n\n> Full reference: [CLI docs](./docs/cli/)\n\n---\n\n## 🔌 MCP Server\n\nLystBot ships with a built-in [MCP](https://modelcontextprotocol.io) server. Works with **Claude Desktop**, **Claude Code**, **Cursor**, **Windsurf**, **Cline**, and any MCP-compatible client.\n\n**First, authenticate** (all setups need this):\n\n```bash\nnpx lystbot login <YOUR_API_KEY>\n```\n\n### Claude Desktop\n\nAdd this to your config file:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"lystbot\": {\n      \"command\": \"npx\",\n      \"args\": [\"lystbot\", \"mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Done.\n\n### Claude Code\n\nOne command:\n\n```bash\nclaude mcp add lystbot -- npx lystbot mcp\n```\n\nThat's it. Claude Code can now manage your lists.\n\n### Cursor / Windsurf / Cline\n\nAdd the same config to your editor's MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"lystbot\": {\n      \"command\": \"npx\",\n      \"args\": [\"lystbot\", \"mcp\"]\n    }\n  }\n}\n```\n\n### Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_lists` | Get all your lists |\n| `get_list` | Get a specific list with items |\n| `create_list` | Create a new list |\n| `delete_list` | Delete a list |\n| `add_items` | Add natural strings or structured `{text, quantity?, unit?}` items |\n| `check_item` | Check off an item |\n| `uncheck_item` | Uncheck an item |\n| `remove_item` | Remove an item from a list |\n| `clear_checked` | Remove all checked (completed) items from a list |\n| `share_list` | Generate a share code for a list |\n| `join_list` | Join a shared list via code |\n| `list_categories` | List categories for a list |\n| `create_category` | Create a category |\n| `rename_category` | Rename a category |\n| `delete_category` | Delete a category |\n| `reorder_categories` | Reorder categories |\n| `move_item` | Move an item to a category (or Other) |\n| `add_item_image` | Attach an image to an item (local path or base64) |\n| `add_item_url` | Attach a link to an item |\n| `list_item_attachments` | List all attachments of an item |\n| `delete_item_attachment` | Delete an attachment by ID |\n| `list_reminders` | Get all reminders |\n| `get_reminder` | Get one reminder |\n| `create_reminder` | Create a reminder |\n| `update_reminder` | Update a reminder |\n| `delete_reminder` | Delete a reminder |\n\n`add_items` understands `250g Mehl`, `3x Milch`, plain counts such as `3 Bananen` / `3 bananas`, and container forms such as `2 Flaschen Wein`. Agents can instead send `[{\"text\":\"Mehl\",\"quantity\":2,\"unit\":\"500g\"}]`; weight belongs in `unit`, not quantity `250`.\n\n---\n\n## 🏗️ Architecture\n\n```\n┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐\n│  Your Phone  │  │   Your AI    │  │  MCP Client  │  │     CLI      │\n│  (LystBot    │  │  (OpenClaw,  │  │  (Claude,    │  │  (npx        │\n│   App)       │  │   ChatGPT)   │  │   Cursor)    │  │   lystbot)   │\n└──────┬───────┘  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘\n       │                 │                 │                 │\n       │ X-Device-UUID   │ Bearer Token    │ MCP Protocol    │ Bearer Token\n       │                 │                 │                 │\n       └────────┬────────┴────────┬────────┴────────┬────────┘\n                │                 │                 │\n         ┌──────▼─────────────────▼─────────────────▼──────┐\n         │               LystBot API                       │\n         │            (REST/JSON + MCP)                     │\n         └─────────────────────────────────────────────────┘\n```\n\n---\n\n## 📚 Documentation\n\n- 📡 **[API Reference](./docs/api/)** - Full endpoint docs with curl examples\n- 💻 **[CLI Reference](./docs/cli/)** - All commands and flags\n- 🔌 **MCP Server** - `npx lystbot mcp` (see [setup above](#-mcp-server))\n\n---\n\n## 🤝 Contributing\n\nWe'd love your help! Whether it's:\n\n- 🐛 Bug reports and feature requests via [Issues](https://github.com/TourAround/LystBot/issues)\n- 🔧 CLI improvements and new commands\n- 📖 Documentation fixes\n\nFork it, branch it, PR it.\n\n---\n\n## 📄 License\n\nMIT - see [LICENSE](./LICENSE) for details.\n\nBuilt with ❤️ by [TourAround UG](https://lystbot.com)\n",
  "bytes": 12230,
  "sha": "7b0fd57378b3933986e9efcf8f53131b9542eabd650bb9516dc2ca749da257e1",
  "repo_slug": "touraround/lystbot",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_touraround_lystbot_9f23fd57/readme"
}