apple-mail-mcp 2.20.0 → 2.20.2

package/README.md

@@ -813,7 +813,10 @@ Save an email to Drafts without sending.
 so a draft with `inReplyTo`/`references` cannot go through AppleScript. Instead the
 server composes it with the same MIME builder as the SMTP send (attachments included) and
 files it over IMAP into the account's Drafts mailbox (SPECIAL-USE `\Drafts`), flagged
-`\Draft`. The account is `account` when given (it must be a configured IMAP account);
+`\Draft`. The account is `account` when given (it must be a configured IMAP account —
+pass the exact `accountLabel` or login from `list-accounts`/your `APPLE_MAIL_MCP_IMAP_*`
+config, e.g. `"user@icloud.com"`; a generic provider name like `"iCloud"` is not a
+recognized alias and is refused);
 otherwise the IMAP account whose login is the SMTP identity, else the only configured
 IMAP account. When none qualifies — IMAP unconfigured, an unknown `account`, or several
 accounts and no way to choose — the call **fails and files nothing**; it never falls back
@@ -1024,7 +1027,18 @@ List attachments on a message.
 | --------- | ------ | -------- | ----------- |
 | `id`      | string | Yes      | Message ID  |
 
-**Returns:** List of attachments with name, MIME type, and size.
+**Returns:** List of attachments with name, MIME type, and `size` — the **decoded** byte count,
+i.e. what `fetch-attachment` returns.
+
+**Sizes over IMAP.** `BODYSTRUCTURE` reports a part's size in its transfer encoding, so a
+base64 attachment's raw figure is ~4/3 of the file. `list-attachments` converts it: a
+`Content-Disposition` `size=` parameter wins when present; 7bit/8bit/binary parts are exact
+as reported; base64 parts are measured exactly from a short tail of each part (padding and
+line wrap), fetched in one batched `FETCH` for the whole message; quoted-printable parts up
+to 64 KiB are fetched and counted exactly. If a part can't be measured (the probe fails, the
+wrap is irregular, or a quoted-printable part is larger), the size is an estimate within a
+few bytes for base64 — an upper bound for quoted-printable — and the entry carries
+`sizeApproximate: true`. `fetch-attachment` always reports the exact `bytes`.
 
 ---