LystBot

Pessoas e agentes de IA podem usar as mesmas listas compartilhadas. O servidor MCP local stdio do LystBot permite que um agente adicione ou verifique itens; as atualizações aparecem no aplicativo. Auto-enviado pelo mantenedor do projeto LystBot.

GitHub

Documentação

Listas inteligentes e lembretes que sua IA pode realmente usar.

LystBot não é mais um aplicativo de listas com IA. Não há IA integrada, nenhum chatbot e nenhuma "sugestão com tecnologia de IA".
Em vez disso, o LystBot dá à sua IA (um agente pessoal no OpenClaw, um Custom GPT, Claude) acesso direto às suas listas e lembretes.
Sua IA escreve nas listas. Você vê o resultado no aplicativo no seu celular.

🚀 Começando

1. Obtenha o aplicativo

Abra o aplicativo, crie sua primeira lista e pegue sua chave de API em Configurações → Agentes de IA.

🖥️ Use no seu navegador

app.lystbot.com: todas as suas listas no desktop. Combine com um código do aplicativo, sem necessidade de conta.

👉 Apenas curioso? Experimente a demonstração: roda totalmente no seu navegador, nada é armazenado.

2. Conecte seu agente de IA

A página de configuração do agente tem instruções passo a passo:

👉 lystbot.com/agents

Existem três maneiras de conectar:

Método	Melhor para	Tempo de configuração
CLI	OpenClaw, Grok Bot, agentes pessoais, scripts, automação	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. É isso

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

Os itens aparecem no aplicativo imediatamente.

🧠 Como funciona

A maioria dos "aplicativos de listas com IA" coloca um chatbot dentro do aplicativo. O LystBot faz o oposto: você continua usando a IA que já tem, e ela controla o LystBot de fora.

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

Não há nova IA para aprender e nenhum prompt dentro do aplicativo. Conecte sua IA existente e deixe-a gerenciar compras, listas de embalagem, tarefas e lembretes.

"Adicione ovos à minha lista de compras" funciona em qualquer IA que você já usa.
Seu celular é a tela. Sua IA escreve, você vê a mudança.
O aplicativo é para humanos, a API é para agentes.
As mudanças sincronizam em tempo real: sua IA adiciona leite, seu parceiro vê imediatamente.

✨ Recursos

Listas: crie, organize e compartilhe listas.
Compartilhamento: convide outras pessoas com um código de compartilhamento e edite a mesma lista juntos.
Plataformas: aplicativos iOS e Android, além de acesso via CLI e API.
Favoritos: acesso rápido a itens que você adiciona com frequência.
Categorias: divida uma lista em seções e mova itens entre elas. Itens sem categoria vão para Outros.
Anexos: adicione imagens e links a itens pelo aplicativo, CLI ou cliente MCP.
Lembretes: sua IA pode criar, atualizar, desativar e excluir lembretes únicos ou recorrentes.
Notificações push: seja notificado quando sua IA ou sua família alterar uma lista.
API REST: qualquer agente de IA pode ler e alterar listas, categorias e lembretes.

Dashboard List Detail Push Notifications

🤖 Integrações de agentes

O LystBot funciona com qualquer IA que possa fazer solicitações HTTP. Veja como conectar a sua:

Agentes pessoais e estruturas autônomas

Agente	Provedor	Integração
OpenClaw	OpenClaw	CLI (`npx lystbot`) ou Servidor MCP
Hermes Agent	Nous Research	Servidor MCP
Grok Bot	xAI	CLI no computador em nuvem do Bot
Devin	Cognition	CLI ou API REST
Aider	Open Source	CLI
OpenCode	Open Source	CLI ou Servidor MCP
AutoGPT	Open Source	API REST
CrewAI	Open Source	API REST ou Servidor MCP
Manus AI	Manus	API REST

Agentes de codificação e IDEs

Agente	Provedor	Integração
Claude Desktop	Anthropic	Servidor MCP (configuração abaixo)
Claude Code	Anthropic	Servidor MCP (configuração abaixo)
Codex	OpenAI	Servidor MCP (configuração abaixo)
Cursor	Anysphere	Servidor MCP
Devin Desktop (antigo Windsurf)	Cognition	Servidor MCP
GitHub Copilot	GitHub	Servidor MCP
Grok Build	xAI	Servidor MCP (configuração abaixo)
Antigravity	Google	Servidor MCP
Cline	Open Source	Servidor MCP

Assistentes de voz e IA de chat

Agente	Provedor	Integração
ChatGPT	OpenAI	Custom GPT com OpenAPI Actions
Google Gemini	Google	Chamada de função da API Gemini com a API REST
Microsoft Copilot	Microsoft	Agente do Copilot Studio com ferramenta de API REST (OpenAPI)
Grok	xAI	Chamada de função da API xAI com a API REST
Siri / Apple Intelligence	Apple	Atalhos da Apple com API REST
Amazon Alexa	Amazon	Habilidade LystBot Alexa

Não vê seu agente? Se ele puder chamar uma API, ele pode usar o LystBot. Consulte a documentação da API.

💻 CLI

A CLI do LystBot gerencia suas listas pelo terminal. Ela é feita para agentes de IA como o OpenClaw, que funcionam melhor com ferramentas de linha de comando, e para quem gosta de automatizar coisas.

Instalar e fazer login

npm install -g lystbot
lystbot login <YOUR_API_KEY>

Sem uma instalação global, prefixe cada comando com npx, por exemplo 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

Referência completa: documentação da CLI

🔌 Servidor MCP

A CLI inclui um servidor MCP. Ele roda localmente via stdio, então funciona com Claude Desktop, Claude Code, Codex, Cursor, Devin Desktop, Grok Build, Antigravity, Cline e qualquer outro cliente MCP que possa iniciar um servidor local.

Para Cline, veja o guia de instalação.

Faça login primeiro. Toda configuração abaixo precisa disso:

npx lystbot login <YOUR_API_KEY>

Claude Desktop

Adicione isso ao seu arquivo de configuração:

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

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

Em seguida, reinicie o Claude Desktop.

Claude Code

claude mcp add lystbot -- npx lystbot mcp

O Claude Code agora pode gerenciar suas 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

Adicione a mesma configuração às configurações de MCP da ferramenta. Para Cursor, é .cursor/mcp.json, para Devin Desktop ~/.config/devin/mcp_config.json e para Antigravity ~/.gemini/config/mcp_config.json. Cline tem sua própria tela de configurações de MCP.

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

Ferramentas disponíveis

Ferramenta	Descrição
`list_lists`	Obtenha todas as suas listas
`get_list`	Obtenha uma lista específica com itens
`create_list`	Crie uma nova lista
`delete_list`	Exclua uma lista
`add_items`	Adicione strings naturais ou itens `{text, quantity?, unit?}` estruturados
`check_item`	Marque um item como concluído
`uncheck_item`	Desmarque um item
`remove_item`	Remova um item de uma lista
`clear_checked`	Remova todos os itens marcados (concluídos) de uma lista
`share_list`	Gere um código de compartilhamento para uma lista
`join_list`	Entre em uma lista compartilhada via código
`list_categories`	Liste categorias de uma lista
`create_category`	Crie uma categoria
`rename_category`	Renomeie uma categoria
`delete_category`	Exclua uma categoria
`reorder_categories`	Reordene categorias
`move_item`	Mova um item para uma categoria (ou Outros)
`add_item_image`	Anexe uma imagem a um item (caminho local ou base64)
`add_item_url`	Anexe um link a um item
`list_item_attachments`	Liste todos os anexos de um item
`delete_item_attachment`	Exclua um anexo por ID
`list_reminders`	Obtenha todos os lembretes
`get_reminder`	Obtenha um lembrete
`create_reminder`	Crie um lembrete
`update_reminder`	Atualize um lembrete
`delete_reminder`	Exclua um lembrete

add_items entende 250g Mehl, 3x Milch, contagens simples como 3 Bananen ou 3 bananas, e formas de contêiner como 2 Flaschen Wein. Agentes também podem enviar itens estruturados como [{"text":"Mehl","quantity":2,"unit":"500g"}]. Pesos vão em unit, então 250 g de farinha é "unit":"250g", não "quantity":250.

🏗️ Arquitetura

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

O servidor MCP roda localmente como lystbot mcp e chama a mesma API REST com sua chave de API.

📚 Documentação

Referência da API: todos os endpoints com exemplos de curl
Referência da CLI: todos os comandos e flags
Servidor MCP: npx lystbot mcp (veja configuração acima)

🤝 Contribuindo

Relatórios de bugs e solicitações de recursos vão para Issues. Pull requests para a CLI e a documentação são bem-vindos.

📄 Licença

MIT - veja LICENSE para detalhes.

Feito com ❤️ por TourAround UG