LystBot

Las personas y los agentes de IA pueden usar las mismas listas compartidas. El servidor MCP local stdio de LystBot permite que un agente agregue o verifique elementos; las actualizaciones aparecen en la aplicación. Enviado por el mantenedor del proyecto LystBot.

GitHub

Documentación

Listas inteligentes y recordatorios que tu IA realmente puede usar.

LystBot no es otra aplicación de listas con IA. No tiene IA integrada, ni chatbot, ni "sugerencias impulsadas por IA".
En cambio, LystBot le da a tu IA (un agente personal en OpenClaw, un Custom GPT, Claude) acceso directo a tus listas y recordatorios.
Tu IA escribe en las listas. Tú ves el resultado en la aplicación de tu teléfono.

🚀 Primeros pasos

1. Obtén la aplicación

Abre la aplicación, crea tu primera lista y obtén tu clave de API en Configuración → Agentes de IA.

🖥️ Úsala en tu navegador

app.lystbot.com: todas tus listas en el escritorio. Combínalo con un código de la aplicación, sin necesidad de cuenta.

👉 ¿Solo tienes curiosidad? Prueba la demo: se ejecuta completamente en tu navegador, no se almacena nada.

2. Conecta tu agente de IA

La página de configuración del agente tiene instrucciones paso a paso:

👉 lystbot.com/agents

Hay tres formas de conectarse:

Método	Ideal para	Tiempo de configuración
CLI	OpenClaw, Grok Bot, agentes personales, scripts, automatización	1 min
Servidor MCP	Claude Desktop, Claude Code, Codex, Cursor, Devin Desktop	2 min
API REST	ChatGPT Actions, Copilot Studio, agentes personalizados, Home Assistant	5 min

3. Eso es todo

npx lystbot login YOUR_API_KEY
npx lystbot add "Groceries" "Oat milk, Bananas, Coffee"

Los elementos aparecen en la aplicación de inmediato.

🧠 Cómo funciona

La mayoría de las "aplicaciones de listas con IA" ponen un chatbot dentro de la aplicación. LystBot hace lo contrario: sigues usando la IA que ya tienes, y esta controla LystBot desde fuera.

You → talk to your AI → AI calls LystBot API → your phone updates instantly

No hay una nueva IA que aprender ni indicaciones dentro de la aplicación. Conecta tu IA existente y deja que gestione compras, listas de equipaje, tareas pendientes y recordatorios.

"Añade huevos a mi lista de la compra" funciona desde cualquier IA que ya uses.
Tu teléfono es la pantalla. Tu IA escribe, tú ves el cambio.
La aplicación es para humanos, la API es para agentes.
Los cambios se sincronizan en tiempo real: tu IA añade leche, tu pareja lo ve de inmediato.

✨ Características

Listas: crea, organiza y comparte listas.
Compartir: invita a otros con un código de uso compartido y edita la misma lista juntos.
Plataformas: aplicaciones para iOS y Android, además de acceso CLI y API.
Favoritos: acceso rápido a los elementos que añades con frecuencia.
Categorías: divide una lista en secciones y mueve elementos entre ellas. Los elementos sin categoría van a Otros.
Adjuntos: añade imágenes y enlaces a elementos desde la aplicación, el CLI o un cliente MCP.
Recordatorios: tu IA puede crear, actualizar, desactivar y eliminar recordatorios únicos o recurrentes.
Notificaciones push: recibe notificaciones cuando tu IA o tu familia cambian una lista.
API REST: cualquier agente de IA puede leer y modificar listas, categorías y recordatorios.

Dashboard List Detail Push Notifications

🤖 Integraciones de agentes

LystBot funciona con cualquier IA que pueda realizar solicitudes HTTP. Así es como conectas la tuya:

Agentes personales y marcos autónomos

Agente	Proveedor	Integración
OpenClaw	OpenClaw	CLI (`npx lystbot`) o servidor MCP
Hermes Agent	Nous Research	Servidor MCP
Grok Bot	xAI	CLI en la computadora en la nube del Bot
Devin	Cognition	CLI o API REST
Aider	Código abierto	CLI
OpenCode	Código abierto	CLI o servidor MCP
AutoGPT	Código abierto	API REST
CrewAI	Código abierto	API REST o servidor MCP
Manus AI	Manus	API REST

Agentes de codificación e IDE

Agente	Proveedor	Integración
Claude Desktop	Anthropic	Servidor MCP (configuración abajo)
Claude Code	Anthropic	Servidor MCP (configuración abajo)
Codex	OpenAI	Servidor MCP (configuración abajo)
Cursor	Anysphere	Servidor MCP
Devin Desktop (antes Windsurf)	Cognition	Servidor MCP
GitHub Copilot	GitHub	Servidor MCP
Grok Build	xAI	Servidor MCP (configuración abajo)
Antigravity	Google	Servidor MCP
Cline	Código abierto	Servidor MCP

Asistentes de voz y chat con IA

Agente	Proveedor	Integración
ChatGPT	OpenAI	Custom GPT con OpenAPI Actions
Google Gemini	Google	Llamada a funciones de la API de Gemini con la API REST
Microsoft Copilot	Microsoft	Agente de Copilot Studio con una herramienta de API REST (OpenAPI)
Grok	xAI	Llamada a funciones de la API de xAI con la API REST
Siri / Apple Intelligence	Apple	Atajos de Apple con API REST
Amazon Alexa	Amazon	Habilidad LystBot para Alexa

¿No ves tu agente? Si puede llamar a una API, puede usar LystBot. Consulta la documentación de la API.

💻 CLI

El CLI de LystBot gestiona tus listas desde la terminal. Está diseñado para agentes de IA como OpenClaw que funcionan mejor con herramientas de línea de comandos, y para cualquiera que le guste automatizar cosas.

Instalación e inicio de sesión

npm install -g lystbot
lystbot login <YOUR_API_KEY>

Sin una instalación global, antepone npx a cada comando, por ejemplo npx lystbot lists.

Comandos

# 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

Referencia completa: documentación del CLI

🔌 Servidor MCP

El CLI incluye un servidor MCP. Se ejecuta localmente a través de stdio, por lo que funciona con Claude Desktop, Claude Code, Codex, Cursor, Devin Desktop, Grok Build, Antigravity, Cline y cualquier otro cliente MCP que pueda iniciar un servidor local.

Para Cline, consulta la guía de instalación.

Inicia sesión primero. Cada configuración a continuación necesita esto:

npx lystbot login <YOUR_API_KEY>

Claude Desktop

Añade esto a tu archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Luego reinicia Claude Desktop.

Claude Code

claude mcp add lystbot -- npx lystbot mcp

Claude Code ahora puede gestionar tus listas.

Codex / Grok Build

codex mcp add lystbot -- npx lystbot mcp   # Codex
grok mcp add lystbot -- npx lystbot mcp    # Grok Build

Cursor / Devin Desktop / Antigravity / Cline

Añade la misma configuración a los ajustes de MCP de la herramienta. Para Cursor es .cursor/mcp.json, para Devin Desktop ~/.config/devin/mcp_config.json y para Antigravity ~/.gemini/config/mcp_config.json. Cline tiene su propia pantalla de ajustes de MCP.

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

Herramientas disponibles

Herramienta	Descripción
`list_lists`	Obtén todas tus listas
`get_list`	Obtén una lista específica con elementos
`create_list`	Crea una nueva lista
`delete_list`	Elimina una lista
`add_items`	Añade cadenas naturales o elementos `{text, quantity?, unit?}` estructurados
`check_item`	Marca un elemento como completado
`uncheck_item`	Desmarca un elemento
`remove_item`	Elimina un elemento de una lista
`clear_checked`	Elimina todos los elementos marcados (completados) de una lista
`share_list`	Genera un código de uso compartido para una lista
`join_list`	Únete a una lista compartida mediante código
`list_categories`	Lista las categorías de una lista
`create_category`	Crea una categoría
`rename_category`	Renombra una categoría
`delete_category`	Elimina una categoría
`reorder_categories`	Reordena categorías
`move_item`	Mueve un elemento a una categoría (o a Otros)
`add_item_image`	Adjunta una imagen a un elemento (ruta local o base64)
`add_item_url`	Adjunta un enlace a un elemento
`list_item_attachments`	Lista todos los adjuntos de un elemento
`delete_item_attachment`	Elimina un adjunto por ID
`list_reminders`	Obtén todos los recordatorios
`get_reminder`	Obtén un recordatorio
`create_reminder`	Crea un recordatorio
`update_reminder`	Actualiza un recordatorio
`delete_reminder`	Elimina un recordatorio

add_items entiende 250g Mehl, 3x Milch, cantidades simples como 3 Bananen o 3 bananas, y formas de contenedor como 2 Flaschen Wein. Los agentes también pueden enviar elementos estructurados como [{"text":"Mehl","quantity":2,"unit":"500g"}]. Los pesos van en unit, así que 250 g de harina es "unit":"250g", no "quantity":250.

🏗️ Arquitectura

┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  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)                       │
         └─────────────────────────────────────────────────┘

El servidor MCP se ejecuta localmente como lystbot mcp y llama a la misma API REST con tu clave de API.

📚 Documentación

Referencia de la API: todos los endpoints con ejemplos de curl
Referencia del CLI: todos los comandos y banderas
Servidor MCP: npx lystbot mcp (consulta la configuración arriba)

🤝 Contribuciones

Los informes de errores y las solicitudes de funciones van a Issues. Las solicitudes de extracción para el CLI y la documentación son bienvenidas.

📄 Licencia

MIT - consulta LICENSE para más detalles.

Hecho con ❤️ por TourAround UG