apple-mail-mcp 2.19.6 → 2.19.7

package/README.md

@@ -236,6 +236,19 @@ Search for messages matching criteria. Searches all accounts by default.
 | `dateTo` | string | No | End date filter (e.g., "March 1, 2026") |
 | `limit` | number | No | Max results, 1–500 (default: 50) |
 
+**Returns:** List of matching messages with ID, date, subject, sender, and read state.
+
+⚠️ **Row dates.** Since 2.19.7 every row — on both the IMAP and AppleScript
+backends — carries both `dateSent` (the message's `Date:` header) and
+`dateReceived` (mailbox arrival — IMAP `INTERNALDATE` or Mail's `date received`).
+They differ legitimately by transit time; when they differ by **years**, the
+mailbox was migrated or re-imported and the arrival timestamp was reset — trust
+`dateSent` for chronology ([#224](https://github.com/sweetrb/apple-mail-mcp/issues/224)).
+`dateSent` is omitted (not invented) when the message carries no parseable
+`Date:` header, or when it is more than 7 days later than `dateReceived` — Mail
+substitutes a timestamp of its own for a `Date:` header it cannot parse
+([#234](https://github.com/sweetrb/apple-mail-mcp/issues/234)).
+
 **Large mailboxes & partial results.** Apple Mail's AppleScript bridge cannot
 search very large IMAP/Gmail mailboxes (tens of thousands of messages) before
 the Apple Event times out — empirically even reading the newest 20 messages of
@@ -331,19 +344,20 @@ List messages in a mailbox.
 
 **Returns:** List of messages with ID, date, subject, and sender.
 
-⚠️ **Row dates differ by backend.** On the **IMAP** path each row carries both
-`dateSent` (the message's `Date:` header) and `dateReceived` (mailbox arrival —
-`INTERNALDATE`, falling back to the header date if the server withholds it).
-They differ legitimately by transit time; when they differ by **years**, the
-mailbox was migrated or re-imported and the arrival timestamp was reset — trust
-`dateSent` for chronology ([#224](https://github.com/sweetrb/apple-mail-mcp/issues/224)).
-Since 2.19.6 the IMAP `dateSent` is recovered even when the server's own parse of
-the `Date:` header failed (legacy locale dates such as `jue ago 30 13:55:12 2007`),
-and is omitted rather than reported when it is more than 7 days later than
-`dateReceived` ([#234](https://github.com/sweetrb/apple-mail-mcp/issues/234)).
-On the **AppleScript** path rows carry only `dateReceived` (Mail's `date
-received`); `dateSent` is not yet emitted there. Sort order keys on the header
-date on both backends, which is the stable one.
+⚠️ **Row dates.** Since 2.19.7 every row — on both the **IMAP** and
+**AppleScript** backends — carries both `dateSent` (the message's `Date:`
+header) and `dateReceived` (mailbox arrival — IMAP `INTERNALDATE`, falling back
+to the header date if the server withholds it; Mail's `date received` on the
+AppleScript path). They differ legitimately by transit time; when they differ
+by **years**, the mailbox was migrated or re-imported and the arrival timestamp
+was reset — trust `dateSent` for chronology
+([#224](https://github.com/sweetrb/apple-mail-mcp/issues/224)). Since 2.19.6 the
+IMAP `dateSent` is recovered even when the server's own parse of the `Date:`
+header failed (legacy locale dates such as `jue ago 30 13:55:12 2007`); both
+backends omit `dateSent` (rather than reporting it) when it is more than 7 days
+later than `dateReceived` ([#234](https://github.com/sweetrb/apple-mail-mcp/issues/234)).
+Before 2.19.7 the AppleScript path carried only `dateReceived`. Sort order keys
+on the header date on both backends, which is the stable one.
 
 ---
 

package/build/index.js

@@ -82203,7 +82203,10 @@ function buildAttachmentCommands(attachments) {
   }
   return commands;
 }
-var AS_DATE_TO_STRING = `((year of d) as string) & "-" & ((month of d as integer) as string) & "-" & ((day of d) as string) & "-" & ((hours of d) as string) & "-" & ((minutes of d) as string) & "-" & ((seconds of d) as string)`;
+function asDateToString(varName) {
+  return `((year of ${varName}) as string) & "-" & ((month of ${varName} as integer) as string) & "-" & ((day of ${varName}) as string) & "-" & ((hours of ${varName}) as string) & "-" & ((minutes of ${varName}) as string) & "-" & ((seconds of ${varName}) as string)`;
+}
+var AS_DATE_TO_STRING = asDateToString("d");
 var AS_MESSAGE_DATES_FRAGMENT = `set msgDateSent to ""
                 try
                   set d to date sent of msg
@@ -82263,6 +82266,12 @@ function buildMessageRowLoop(opts) {
       on error
         set _bulkOK to false
       end try
+      set _sentBulkOK to true
+      try
+        set _sentDates to date sent of _msgs
+      on error
+        set _sentBulkOK to false
+      end try
       repeat with _i from 1 to (count of _msgs)
         if msgCount >= ${limit} then exit repeat
         try
@@ -82292,8 +82301,17 @@ function buildMessageRowLoop(opts) {
             set msgFlagged to flagged status of _m as string
           end if${attRow}
           set msgDateStr to ${AS_DATE_TO_STRING}
+          set msgDateSentStr to ""
+          try
+            if _bulkOK and _sentBulkOK then
+              set dSent to item _i of _sentDates
+            else
+              set dSent to date sent of (item _i of _msgs)
+            end if
+            set msgDateSentStr to ${asDateToString("dSent")}
+          end try
           if msgCount > 0 then set outputText to outputText & "${RECORD_SEP}"
-          set outputText to outputText & msgId & "${FIELD_SEP}" & msgSubject & "${FIELD_SEP}" & msgSender & "${FIELD_SEP}" & msgDateStr & "${FIELD_SEP}" & msgRead & "${FIELD_SEP}" & msgFlagged${trailing}${attField}
+          set outputText to outputText & msgId & "${FIELD_SEP}" & msgSubject & "${FIELD_SEP}" & msgSender & "${FIELD_SEP}" & msgDateStr & "${FIELD_SEP}" & msgDateSentStr & "${FIELD_SEP}" & msgRead & "${FIELD_SEP}" & msgFlagged${trailing}${attField}
           set msgCount to msgCount + 1
           ${dateClose}
           ${offsetClose}
@@ -84147,9 +84165,12 @@ ${indent}end try${this.sanitizeFragment("_uacct", indent)}${this.sanitizeFragmen
   /**
    * Parse message list output from AppleScript.
    *
+   * Row shape (since the dateSent field was added — see buildMessageRowLoop):
+   *   id|subject|sender|dateReceived|dateSent|read|flagged[|mailbox][|hasAtt]
+   *
    * Two emission schemas, disambiguated by length:
-   *   7 fields: single-mailbox — ...|hasAtt (mailbox from caller)
-   *   8 fields: all-mailboxes — ...|mailbox|hasAtt
+   *   8 fields: single-mailbox — ...|hasAtt (mailbox from caller)
+   *   9 fields: all-mailboxes — ...|mailbox|hasAtt
    *
    * `hasAttachments` here is the fast-path AppleScript count only; it will
    * false-negative for MIME-embedded attachments (a known AppleScript
@@ -84160,24 +84181,27 @@ ${indent}end try${this.sanitizeFragment("_uacct", indent)}${this.sanitizeFragmen
     const messages = [];
     for (const item of items) {
       const parts = item.split(FIELD_SEP);
-      if (parts.length < 6) continue;
+      if (parts.length < 7) continue;
       let msgMailbox = mailbox;
       let hasAttachments = false;
-      if (rowsIncludeMailbox && parts.length >= 7) {
-        msgMailbox = parts[6];
-        hasAttachments = parts.length >= 8 ? parts[7] === "true" : false;
-      } else if (parts.length === 7) {
-        hasAttachments = parts[6] === "true";
+      if (rowsIncludeMailbox && parts.length >= 8) {
+        msgMailbox = parts[7];
+        hasAttachments = parts.length >= 9 ? parts[8] === "true" : false;
+      } else if (parts.length === 8) {
+        hasAttachments = parts[7] === "true";
       }
       const msgId = parts[0].trim();
+      const dateReceived = parseAppleScriptDate(parts[3]);
+      const dateSent = plausibleDateSent(parseAppleScriptDate(parts[4]), dateReceived);
       messages.push({
         id: msgId,
         subject: parts[1],
         sender: parts[2],
         recipients: [],
-        dateReceived: parseAppleScriptDate(parts[3]),
-        isRead: parts[4] === "true",
-        isFlagged: parts[5] === "true",
+        dateReceived,
+        ...dateSent ? { dateSent } : {},
+        isRead: parts[5] === "true",
+        isFlagged: parts[6] === "true",
         isJunk: false,
         isDeleted: false,
         mailbox: msgMailbox,
@@ -86826,6 +86850,13 @@ function messageSummary(m) {
     // follow-up) — omitted-as-empty, never invented, same contract as the IMAP
     // rows' `isoOrEmpty`.
     dateReceived: m.dateReceived instanceof Date ? Number.isNaN(m.dateReceived.getTime()) ? "" : m.dateReceived.toISOString() : m.dateReceived,
+    // Same omitted-as-empty-string contract as dateReceived above, and the
+    // same shape the IMAP path's `structuredRow` already emits for
+    // `dateSent`. `m.dateSent` is only ever set to an already-plausible, valid
+    // Date here (appleMailManager.ts's `parseMessageList` applies the
+    // `plausibleDateSent` guard before populating it), so this mainly covers
+    // the "absent" case, but stays defensive against an invalid Date too.
+    dateSent: m.dateSent instanceof Date ? Number.isNaN(m.dateSent.getTime()) ? "" : m.dateSent.toISOString() : "",
     isRead: m.isRead,
     isFlagged: m.isFlagged,
     mailbox: m.mailbox,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-mail-mcp",
-  "version": "2.19.6",
+  "version": "2.19.7",
   "description": "MCP server for Apple Mail - read, search, send, and manage emails via Claude and other AI assistants",
   "type": "module",
   "main": "build/index.js",