Search, read, and extract attachments from Apple Mail's local storage. Query emails by sender, recipient, subject, body, date, mailbox, and flags. Read raw RFC822 messages and extract file attachments.
Install
npx skills add mitsuhiko/agent-stuff --skill apple-mailnpx skills add mitsuhiko/agent-stuff --skill apple-mail -a claude-code -gnpx skills add mitsuhiko/agent-stuff --skill apple-mail -a codex -ggemini skills install https://github.com/mitsuhiko/agent-stuff.git --path skills/apple-mailgh skill install mitsuhiko/agent-stuff apple-mailgit clone --depth 1 https://github.com/mitsuhiko/agent-stuff /tmp/mitsuhiko__agent-stuff
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/mitsuhiko__agent-stuff/skills/apple-mail ~/.claude/skills/apple-mail # Claude Code
cp -R /tmp/mitsuhiko__agent-stuff/skills/apple-mail ~/.agents/skills/apple-mail # Codex, Cursor, Gemini CLI, Copilot, OpenCode