apple-mail-mcp 2.17.9 → 2.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +18 -3
  2. package/build/cli.js +47212 -333
  3. package/build/index.js +20065 -19848
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -357,9 +357,17 @@ Mail.app path.
357
357
 
358
358
  Two differences to know when SMTP is auto-preferred:
359
359
 
360
- - **No Sent-folder copy.** SMTP submission does not file the message in Mail.app's
361
- Sent mailbox (the server's own "save to Sent" may, depending on provider). Use
362
- `transport: "applescript"` if you need the local Sent copy.
360
+ - **Sent-folder copy is best-effort over IMAP.** SMTP submission itself never
361
+ touches IMAP, so since 2.18.0 the server files the sent message into the Sent
362
+ mailbox of whichever configured IMAP account's login matches the SMTP identity
363
+ (`APPLE_MAIL_MCP_IMAP_*` mirroring `APPLE_MAIL_MCP_SMTP_*`), flagged `\Seen`.
364
+ The copy carries the same `Message-ID` that was delivered, so replies thread
365
+ against it correctly, and it keeps the `Bcc` header the recipients never see —
366
+ your own archive is exactly where that belongs. Results report `sentCopy: true`
367
+ or `sentCopy: false` with `sentCopyError`; the field is **absent** when no
368
+ configured IMAP account matches the SMTP identity, which is a skip, not a
369
+ failure. A copy that fails never fails the send — the mail has already gone.
370
+ Use `transport: "applescript"` if you want Mail.app itself to file the copy.
363
371
  - **`account` is a From override, not account selection.** Over SMTP, `account`
364
372
  is used as the From address only when it is an email address; a Mail.app
365
373
  account *label* (e.g. `"Work"`) can't select an account over SMTP, so a call
@@ -1901,6 +1909,13 @@ In a JSON string literal, `\\` — two characters — denotes **one** literal ba
1901
1909
  - macOS needs automation permission
1902
1910
  - Go to System Settings > Privacy & Security > Automation
1903
1911
  - Ensure your terminal/Claude has permission to control Mail
1912
+ - **On a Mac that isn't set to US English**, macOS words this refusal in the system
1913
+ language — `Not authorised to send Apple events to Mail. (-1743)` on en-GB/en-AU/en-IE,
1914
+ and fully translated on fr/de/es. Before **v2.17.10** the server didn't recognise
1915
+ those spellings, so `health-check`/`doctor` reported `permissions: ok` and then blamed
1916
+ missing accounts (*"No Mail accounts found. Set up an account in Mail.app first."*).
1917
+ If you see that on a Mac whose Mail accounts are already configured, upgrade and
1918
+ re-run `doctor`.
1904
1919
 
1905
1920
  ### "Message not found"
1906
1921
  - Message may have been deleted or moved