Repository navigation
Added
list_email_attachmentsandsave_email_attachmentacceptmessage_id(the idsearch_emailsreturns) andmailbox, looking the message up directly instead of by subject, so recurring subjects can't pick the wrong month (#128 by @proscar87).read_email(account, message_id, mailbox)returns one message as headers, plain-text body and attachment list, looked up directly by the idsearch_emailsreturns, with the body capped atmax_charsand the cut stated (#128 by @proscar87).
Security
- The write-path denylist now also checks the path as requested, not only its
symlink target. A symlink inside a protected folder (e.g.
/opt/homebrew/bin/python3) resolves outside it, so writing through it was
allowed (#125 by @proscar87, follow-up to #103). - Hardened the file-path guard for file-writing tools (#103, follow-up to #19).
The old denylist missed shell startup files, so a prompt-injected
save_email_attachment(save_path="~/.zshrc")could plant an attacker-supplied
attachment that ran on the next shell.save_email_attachment,
export_emailsandcreate_rich_email_draft'soutput_path(previously
unchecked) now refuse every dotfile and dot-folder directly in$HOME
(~/.zshrc,~/.ssh,~/.gitconfig,~/.config,~/.netrc, ...),
.git/hooks,.git/configand.envrcanywhere, autostart and persistence
locations (~/Library/LaunchAgents,/Library/LaunchDaemons,
~/Library/Application Support,~/Library/Preferences, ...) andPATH
folders (~/bin,/usr/local/bin,/opt/homebrew/bin). Everything else
stays writable, including paths outside$HOMEsuch as the temp dir. - Attachment paths for
compose_emailandreply_to_emailmay now be any
readable file (previously$HOMEonly) except secrets:~/.ssh,~/.gnupg,
~/.aws,~/.netrc, git/cloud credentials,.envfiles,
~/Library/Keychainsand browser profiles and cookie stores. - New opt-in restriction:
APPLE_MAIL_MCP_WRITE_DIRSand
APPLE_MAIL_MCP_ATTACH_DIRS(colon-separated), or the repeatable
--write-dir/--attach-dirflags, confine writes or attachments to the
listed folders; the denylist still applies inside them. - All checks live in one shared module (
apple_mail_mcp/paths.py) instead of
three copies, resolve..and symlinks before checking, and compare
case-insensitively to match APFS (~/.ZSHRCis~/.zshrc).
Fixed
list_inbox_emailsin text output andget_mailbox_unread_counts(summary_only=True)
ignoredaccountand returned every account; they now filter by it
(#135 by @proscar87).search_emailson a mailbox over the whose-clause limit now stops its
bounded index scan at the first message outside adate_fromwindow
(newest-first) ordate_towindow (oldest-first), instead of reading the
full 4000-message cap. A one-week search of a 6,000-message mailbox no
longer holds the automation lock for minutes (#133 by
@joel-alturaeducation, related to #87 and #132).- The Claude Code plugin manifests (
plugin/.claude-plugin/plugin.json,
.claude-plugin/marketplace.json) were stuck at 3.1.2, soclaude plugin updatereported installs as current. They are now at 3.2.1 and
scripts/check_versions.pyandRELEASING.mdcover them (#127 by
@proscar87). move_emailno longer treats a negativeolder_than_daysas a filter (it
added no date condition, so the call moved everything), andmanage_trash
rejects an unrecognisedactioninstead of falling through to
move_to_trash(#124 by @proscar87).reply_to_emailnow restores the user's clipboard. The restore step sat
after the script'sreturn, so it never ran and every reply (send, draft
or open) left the reply body on the clipboard. The error path now restores
it too, as doesforward_email's error path when amessagewas pasted
(#106).
What's Changed
- docs: support installing the skill via npx skills by @patrickfreyer in #116
- refactor: reuse _COMPOSE_FONT_STYLE and test reply/forward font (#100 follow-up) by @patrickfreyer in #115
- fix: verify saved reply drafts (carries #92 and #91) by @patrickfreyer in #114
- fix: bound the get_awaiting_reply inbox scan so large mailboxes stop timing out by @patrickfreyer in #117
- fix: bound the get_awaiting_reply inbox scan so large mailboxes stop timing out by @karrolcia in #90
- fix: keep account names containing | intact by @patrickfreyer in #120
- fix: keep account names containing | intact by @herbeckrobin in #107
- fix: add a mailbox parameter to save_email_attachment by @patrickfreyer in #121
- fix: add a mailbox parameter to save_email_attachment by @herbeckrobin in #109
- fix: report the real trash count in manage_trash by @patrickfreyer in #122
- fix: report the real trash count in manage_trash by @herbeckrobin in #108
- fix: group get_email_thread by Message-ID instead of subject by @patrickfreyer in #123
- fix: group get_email_thread by Message-ID instead of subject by @herbeckrobin in #110
- fix: serialize concurrent AppleScript calls to Mail.app across plugin processes by @patrickfreyer in #118
- fix: serialize concurrent AppleScript calls to Mail.app across plugin processes by @ahharvey in #94
- fix: make --read-only block delivery instead of the compose tools by @patrickfreyer in #119
- fix: make --read-only block delivery instead of the compose tools by @herbeckrobin in #95
- fix: harden the file-write path guard (#103) by @patrickfreyer in #112
- fix: restore the clipboard after reply_to_email (#106) by @patrickfreyer in #111
- Carry #124: stop invalid inputs from turning move_email and manage_trash destructive by @patrickfreyer in #129
- fix: stop invalid inputs from turning move_email and manage_trash destructive by @proscar87 in #124
- Carry #127: bump Claude Code plugin manifests to 3.2.1 and guard them by @patrickfreyer in #130
- fix: bump the Claude Code plugin manifests to 3.2.1 and guard them by @proscar87 in #127
- Carry #125: check the requested path, not only its symlink target, against the write denylist by @patrickfreyer in #131
- fix: check the requested path, not only its symlink target, against the write denylist by @proscar87 in #125
- fix: stop the bounded search scan once it passes the date window (#133) by @patrickfreyer in #134
- fix: honour the account in list_inbox_emails text output and unread summary by @proscar87 in #135
- feat: read_email — one message by id as headers, text body and attachment list by @proscar87 in #136
- Carry #137: list and save attachments by message_id by @patrickfreyer in #138
- feat: list and save attachments by message_id by @proscar87 in #137
- Release 3.3.0 by @patrickfreyer in #139
New Contributors
- @karrolcia made their first contribution in #90
- @herbeckrobin made their first contribution in #107
Full Changelog: v3.2.1...v3.3.0