an agent skill that gives AI assistants full control over macOS Mail.app. triage your inbox, draft replies, search, move, delete, and label emails - all through natural language.
# cursor
git clone https://github.com/openclaw/apple-mail.git .cursor/skills/apple-mail
# claude code
git clone https://github.com/openclaw/apple-mail.git .claude/skills/apple-mail
# openclaw
git clone https://github.com/openclaw/apple-mail.git .openclaw/skills/apple-mailrequires macOS with Mail.app configured, micromamba, and full disk access for Terminal. on first run, mail.sh bootstraps a Python 3.11 environment automatically.
- reads
.emlxfiles directly from disk (~5 ms per message vs seconds via scripting bridge) - falls back to JXA when disk access misses
- maintains a SQLite FTS5 index for fast full-text search
- all destructive operations log their actions and support
--dry-run - nothing sends without explicit user confirmation
full command reference in SKILL.md and references/tool-reference.md.
the disk-first reading approach and FTS5 search index design were inspired by imdinu/jxa-mail-mcp.
MIT