openclaw-apple-mail - Apple Mail Integration Plugin

🚀 Quick Start

Installation

# Install from npm
npm install @jehadurre/openclaw-apple-mail

# For OpenClaw
openclaw plugins install @jehadurre/openclaw-apple-mail

# For Hermes
hermes plugins install @jehadurre/openclaw-apple-mail

View on GitHub View on npm

✨ Key Features

🔒 Per-Thread Session Isolation

Each email thread gets its own isolated OpenClaw/Hermes session, preventing conversation mixing.

🛡️ Security First

Allowlist enforcement, self-reply prevention, and outbound restrictions keep your agent secure.

📊 HTML Table Support

Extract and process HTML tables from emails with proper sanitization.

⚙️ Highly Configurable

Customize polling intervals, reply policies, and thread context management.

📖 How It Works

openclaw-apple-mail uses AppleScript to integrate with Mail.app on macOS:

Polling: Monitors Mail.app INBOX for unread messages
Filtering: Only processes messages from senders in allowlist
Thread Detection: Generates stable thread IDs from subject + sender
Session Isolation: Each thread uses unique session key
Reply: Uses AppleScript to reply in the same thread

⚙️ Configuration

Add to your ~/.openclaw/openclaw.json or ~/.hermes/hermes.json:

{
  "channels": {
    "apple-mail": {
      "enabled": true,
      "accounts": {
        "your-email@example.com": {
          "email": "your-email@example.com",
          "mailboxAccount": "iCloud",
          "allowFrom": [
            "allowed-sender@example.com"
          ],
          "pollIntervalMs": 30000,
          "archiveOnReply": false
        }
      }
    }
  }
}

📝 Requirements

macOS with Mail.app configured
OpenClaw >= 2026.1.0 or Hermes >= 2026.1.0
Node.js >= 18.0.0

👤 Author

Md. Jehadur Rahman (Emran)

GitHub • Website • Dev.to

🤝 Contributing

Contributions are welcome! Check out the Contributing Guide to get started.

Report an Issue Submit a PR