Email Checker for Mac#

Automated email assistant for Apple Mail on macOS. Runs on a schedule, scores your unread emails by priority, drafts AI replies, and sends you a report — so you can manage your inbox from Telegram or WhatsApp without ever opening Mail.app.

Installation#

bash

git clone https://github.com/entzclaw/email-checker-for-mac
cd email-checker-for-mac
bash setup.sh

Setup#

The wizard handles everything:

1. Auto-discovers your Mail.app accounts
2. Prompts for name, report email, trusted senders
3. Picks your LLM provider (LM Studio, Ollama, OpenAI, or skip)
4. Tests the connection and writes config/settings.json
5. Installs the crontab

Usage#

bash

# Run a manual check
python3 scripts/email/checker.py

# Send a reply
python3 scripts/email/send_reply.py \
    --to colleague@example.com \
    --subject "Re: Something" \
    --content "Your reply here"

# Check logs
tail -f logs/email_check.log

OpenClaw Integration#

Tell OpenClaw via Telegram or WhatsApp:

"Run the email checker now" "Send the draft reply to Alice" "Add @company.com to my trusted senders"

Supported LLM Providers#

ProviderNotesLM StudioLocal or remote vLLM endpointOllamaLocalOpenAIRequires API keyNoneReports without AI drafts

Requirements#

• macOS (tested on Tahoe 26.3, Apple Silicon)
• Python 3
• Mail.app with at least one configured account
• Automation permission: System Settings → Privacy & Security → Automation → Terminal → Mail