Skip to content

v3.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 03 Nov 03:36
· 17 commits to main since this release
daaf963

Added

  • list_email_attachments and save_email_attachment accept message_id (the id search_emails returns) and mailbox, 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 id search_emails returns, with the body capped at max_chars and 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_emails and create_rich_email_draft's output_path (previously
    unchecked) now refuse every dotfile and dot-folder directly in $HOME
    (~/.zshrc, ~/.ssh, ~/.gitconfig, ~/.config, ~/.netrc, ...),
    .git/hooks, .git/config and .envrc anywhere, autostart and persistence
    locations (~/Library/LaunchAgents, /Library/LaunchDaemons,
    ~/Library/Application Support, ~/Library/Preferences, ...) and PATH
    folders (~/bin, /usr/local/bin, /opt/homebrew/bin). Everything else
    stays writable, including paths outside $HOME such as the temp dir.
  • Attachment paths for compose_email and reply_to_email may now be any
    readable file (previously $HOME only) except secrets: ~/.ssh, ~/.gnupg,
    ~/.aws, ~/.netrc, git/cloud credentials, .env files,
    ~/Library/Keychains and browser profiles and cookie stores.
  • New opt-in restriction: APPLE_MAIL_MCP_WRITE_DIRS and
    APPLE_MAIL_MCP_ATTACH_DIRS (colon-separated), or the repeatable
    --write-dir / --attach-dir flags, 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 (~/.ZSHRC is ~/.zshrc).

Fixed

  • list_inbox_emails in text output and get_mailbox_unread_counts(summary_only=True)
    ignored account and returned every account; they now filter by it
    (#135 by @proscar87).
  • search_emails on a mailbox over the whose-clause limit now stops its
    bounded index scan at the first message outside a date_from window
    (newest-first) or date_to window (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, so claude plugin update reported installs as current. They are now at 3.2.1 and
    scripts/check_versions.py and RELEASING.md cover them (#127 by
    @proscar87).
  • move_email no longer treats a negative older_than_days as a filter (it
    added no date condition, so the call moved everything), and manage_trash
    rejects an unrecognised action instead of falling through to
    move_to_trash (#124 by @proscar87).
  • reply_to_email now restores the user's clipboard. The restore step sat
    after the script's return, 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 does forward_email's error path when a message was pasted
    (#106).

What's Changed

New Contributors

Full Changelog: v3.2.1...v3.3.0