Skip to main content
Email is available as a plugin. Install it with lukan plugin install-remote or from the Web UI plugin manager.

Setup

# Gmail preset
lukan mail setup gmail user@gmail.com

# Outlook preset
lukan mail setup outlook user@outlook.com

# Whitelist sender and enable
lukan mail allow sender@example.com
lukan mail on
lukan email

Commands

lukan email                      # Start Email channel
lukan mail on                    # Enable Email
lukan mail off                   # Disable Email
lukan mail setup gmail|outlook <email>  # Setup with preset
lukan mail allow <email>         # Whitelist an email
lukan mail deny <email>          # Remove from whitelist
lukan mail prefix [value]        # Get or set subject prefix filter
lukan mail tools list|add|remove|reset  # Manage allowed tools
lukan mail status                # Show configuration
lukan mail test                  # Test SMTP and IMAP connections

Features

  • IMAP polling - Receives emails via IMAP
  • SMTP sending - Sends responses via SMTP
  • Whitelist required - No emails processed if empty
  • Prefix filtering - Optional subject prefix filter (case-insensitive)
  • Max response - 10,000 characters
  • Automatic reconnect - Reconnects on failure

Configuration

{
  "email": {
    "enabled": true,
    "smtp": { "host": "smtp.gmail.com", "port": 587, "secure": false, "user": "...", "pass": "..." },
    "imap": { "host": "imap.gmail.com", "port": 993, "secure": true, "user": "...", "pass": "..." },
    "whitelist": ["boss@example.com"],
    "prefix": "[lukan]",
    "tools": ["Grep", "Glob", "ReadFile", "WebSearch", "WebFetch"]
  }
}

Email Tools

ToolDescription
EmailListList emails (folder, unseen filter, limit)
EmailReadRead email by UID
EmailReplyReply to an email with threading headers
EmailSendSend a new email
EmailFoldersList available email folders
EmailConfirmConfirm a pending email send
EmailCancelCancel a pending email