中文文档

apple-mail

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.

install

# 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-mail

requires macOS with Mail.app configured, micromamba, and full disk access for Terminal. on first run, mail.sh bootstraps a Python 3.11 environment automatically.

how it works

• reads .emlx files 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.

acknowledgements

the disk-first reading approach and FTS5 search index design were inspired by imdinu/jxa-mail-mcp.

license

MIT