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.
- package/README.md +18 -3
- package/build/cli.js +47212 -333
- package/build/index.js +20065 -19848
- 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
|
-
- **
|
|
361
|
-
|
|
362
|
-
|
|
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
|