apple-mail-mcp 2.19.13 → 2.19.14

package/build/cli.js

@@ -58391,6 +58391,13 @@ function structuredRow(m, account, path) {
     ...env.messageId ? { messageId: env.messageId } : {}
   };
 }
+function describeMailboxFailure(error) {
+  const raw = error instanceof Error ? error.message : String(error);
+  const oneLine = raw.split("\n")[0].trim();
+  const looksSensitive = /pass(word)?\s*[:=]|authorization:\s*\S|bearer\s+\S{10,}/i.test(oneLine);
+  const safe = looksSensitive ? "IMAP error (detail redacted \u2014 response text looked like it might contain a credential)" : oneLine || "unknown error";
+  return safe.length > 300 ? `${safe.slice(0, 300)}\u2026` : safe;
+}
 function hasMailboxFlag(mailbox, wanted) {
   const normalized = wanted.toLowerCase();
   return [...mailbox.flags ?? []].some((flag) => flag.toLowerCase() === normalized);
@@ -58472,6 +58479,7 @@ async function run(args, listMode, deps) {
       const newestPerMailbox = offset + limit;
       const fetched = [];
       const failedMailboxes = [];
+      const failedMailboxReasons = {};
       let totalMatched = 0;
       for (const path of paths) {
         try {
@@ -58480,14 +58488,16 @@ async function run(args, listMode, deps) {
           fetched.push(...result.messages.map((message) => ({ message, path })));
         } catch (error) {
           failedMailboxes.push(path);
+          failedMailboxReasons[path] = describeMailboxFailure(error);
           console.error(
             `IMAP ${listMode ? "list" : "search"} failed for account "${cfg.accountLabel}", mailbox "${path}": ${String(error)}`
           );
         }
       }
       if (failedMailboxes.length === paths.length) {
+        const detail = failedMailboxes.map((path) => `${path} (${failedMailboxReasons[path]})`).join(", ");
         throw new Error(
-          `IMAP ${listMode ? "list" : "search"} failed in every requested mailbox for account ${cfg.accountLabel}: ${failedMailboxes.join(", ")}.`
+          `IMAP ${listMode ? "list" : "search"} failed in every requested mailbox for account ${cfg.accountLabel}: ${detail}.`
         );
       }
       let ordered = fetched;
@@ -58509,7 +58519,7 @@ async function run(args, listMode, deps) {
       const partial = failedMailboxes.length > 0;
       const failureNote = partial ? `
 
-Partial result. Could not search mailbox(es): ${failedMailboxes.map((path) => `"${path}"`).join(", ")}.` : "";
+Partial result. Could not search mailbox(es): ${failedMailboxes.map((path) => `"${path}" (${failedMailboxReasons[path]})`).join(", ")}.` : "";
       const verb = listMode ? "listed" : "matched";
       const scope = unscopedSearch ? allMailboxCount === 1 ? `mailbox "${paths[0]}"` : `${allMailboxCount} selectable mailboxes` : `mailbox "${paths[0]}"`;
       if (messages.length === 0) {
@@ -58518,14 +58528,22 @@ Partial result. Could not search mailbox(es): ${failedMailboxes.map((path) => `"
           messages,
           count: 0,
           partial,
-          failedMailboxes
+          failedMailboxes,
+          failedMailboxReasons
         };
       }
       const text = `Found ${rows.length} message(s) via IMAP (server-side, account ${cfg.accountLabel}, ${scope}; ${totalMatched} total ${verb}):
 ` + rows.join("\n") + `
 
 Note: these IMAP IDs (imap:\u2026) work with get-message and the message mutations (mark/flag/move/delete-message), which route back to IMAP.` + failureNote;
-      return { text, messages, count: messages.length, partial, failedMailboxes };
+      return {
+        text,
+        messages,
+        count: messages.length,
+        partial,
+        failedMailboxes,
+        failedMailboxReasons
+      };
     },
     true
   );

package/build/index.js

@@ -65720,6 +65720,13 @@ function structuredRow(m, account, path) {
     ...env.messageId ? { messageId: env.messageId } : {}
   };
 }
+function describeMailboxFailure(error2) {
+  const raw = error2 instanceof Error ? error2.message : String(error2);
+  const oneLine = raw.split("\n")[0].trim();
+  const looksSensitive = /pass(word)?\s*[:=]|authorization:\s*\S|bearer\s+\S{10,}/i.test(oneLine);
+  const safe = looksSensitive ? "IMAP error (detail redacted \u2014 response text looked like it might contain a credential)" : oneLine || "unknown error";
+  return safe.length > 300 ? `${safe.slice(0, 300)}\u2026` : safe;
+}
 function hasMailboxFlag(mailbox, wanted) {
   const normalized = wanted.toLowerCase();
   return [...mailbox.flags ?? []].some((flag) => flag.toLowerCase() === normalized);
@@ -65801,6 +65808,7 @@ async function run(args, listMode, deps) {
       const newestPerMailbox = offset + limit;
       const fetched = [];
       const failedMailboxes = [];
+      const failedMailboxReasons = {};
       let totalMatched = 0;
       for (const path of paths) {
         try {
@@ -65809,14 +65817,16 @@ async function run(args, listMode, deps) {
           fetched.push(...result.messages.map((message) => ({ message, path })));
         } catch (error2) {
           failedMailboxes.push(path);
+          failedMailboxReasons[path] = describeMailboxFailure(error2);
           console.error(
             `IMAP ${listMode ? "list" : "search"} failed for account "${cfg.accountLabel}", mailbox "${path}": ${String(error2)}`
           );
         }
       }
       if (failedMailboxes.length === paths.length) {
+        const detail = failedMailboxes.map((path) => `${path} (${failedMailboxReasons[path]})`).join(", ");
         throw new Error(
-          `IMAP ${listMode ? "list" : "search"} failed in every requested mailbox for account ${cfg.accountLabel}: ${failedMailboxes.join(", ")}.`
+          `IMAP ${listMode ? "list" : "search"} failed in every requested mailbox for account ${cfg.accountLabel}: ${detail}.`
         );
       }
       let ordered = fetched;
@@ -65838,7 +65848,7 @@ async function run(args, listMode, deps) {
       const partial2 = failedMailboxes.length > 0;
       const failureNote = partial2 ? `
 
-Partial result. Could not search mailbox(es): ${failedMailboxes.map((path) => `"${path}"`).join(", ")}.` : "";
+Partial result. Could not search mailbox(es): ${failedMailboxes.map((path) => `"${path}" (${failedMailboxReasons[path]})`).join(", ")}.` : "";
       const verb = listMode ? "listed" : "matched";
       const scope = unscopedSearch ? allMailboxCount === 1 ? `mailbox "${paths[0]}"` : `${allMailboxCount} selectable mailboxes` : `mailbox "${paths[0]}"`;
       if (messages.length === 0) {
@@ -65847,14 +65857,22 @@ Partial result. Could not search mailbox(es): ${failedMailboxes.map((path) => `"
           messages,
           count: 0,
           partial: partial2,
-          failedMailboxes
+          failedMailboxes,
+          failedMailboxReasons
         };
       }
       const text = `Found ${rows.length} message(s) via IMAP (server-side, account ${cfg.accountLabel}, ${scope}; ${totalMatched} total ${verb}):
 ` + rows.join("\n") + `
 
 Note: these IMAP IDs (imap:\u2026) work with get-message and the message mutations (mark/flag/move/delete-message), which route back to IMAP.` + failureNote;
-      return { text, messages, count: messages.length, partial: partial2, failedMailboxes };
+      return {
+        text,
+        messages,
+        count: messages.length,
+        partial: partial2,
+        failedMailboxes,
+        failedMailboxReasons
+      };
     },
     true
   );
@@ -87359,6 +87377,7 @@ async function fanOutImapMessages(args, kind, deps = {}, configs = resolveImapCo
   const accountsQueried = [];
   const accountsFailed = [];
   const failedMailboxes = [];
+  const failedMailboxReasons = {};
   for (const config2 of configs) {
     const perAccountArgs = { ...args, account: void 0 };
     try {
@@ -87368,12 +87387,15 @@ async function fanOutImapMessages(args, kind, deps = {}, configs = resolveImapCo
       failedMailboxes.push(
         ...res.failedMailboxes.map((mailbox) => `${config2.accountLabel} / ${mailbox}`)
       );
+      for (const [mailbox, reason] of Object.entries(res.failedMailboxReasons)) {
+        failedMailboxReasons[`${config2.accountLabel} / ${mailbox}`] = reason;
+      }
     } catch (e) {
       accountsFailed.push(config2.accountLabel);
       console.error(`IMAP fan-out failed for account "${config2.accountLabel}": ${String(e)}`);
     }
   }
-  return { rows, accountsQueried, accountsFailed, failedMailboxes };
+  return { rows, accountsQueried, accountsFailed, failedMailboxes, failedMailboxReasons };
 }
 function configMatchesAccount(config2, account) {
   const name = account.name.trim().toLowerCase();
@@ -87973,7 +87995,10 @@ var LIST_OUTPUT_SCHEMA = {
   skippedLargeMailboxes: external_exports.array(external_exports.string()).optional(),
   notSearchedMailboxes: external_exports.array(external_exports.string()).optional(),
   timedOutAccounts: external_exports.array(external_exports.string()).optional(),
-  failedMailboxes: external_exports.array(external_exports.string()).optional()
+  failedMailboxes: external_exports.array(external_exports.string()).optional(),
+  // Underlying error text per entry in `failedMailboxes`, same keys (#246
+  // follow-up) — declared so a client can rely on it rather than parse text.
+  failedMailboxReasons: external_exports.record(external_exports.string(), external_exports.string()).optional()
 };
 var BATCH_COUNT_OUTPUT_SCHEMA = {
   ok: external_exports.boolean().optional(),
@@ -88063,7 +88088,8 @@ function mergedMessageResponse(fan, apple, limit, verb) {
     skippedLargeMailboxes: diagnostics.skippedLargeMailboxes,
     notSearchedMailboxes: diagnostics.notSearchedMailboxes,
     timedOutAccounts: diagnostics.timedOutAccounts,
-    failedMailboxes: fan.failedMailboxes
+    failedMailboxes: fan.failedMailboxes,
+    failedMailboxReasons: fan.failedMailboxReasons
   };
   const coverageBlock = partialCoverageBlock(diagnostics);
   if (merged.length === 0) {
@@ -88165,7 +88191,8 @@ registerTool(
             messages: r.messages,
             count: r.count,
             partial: r.partial,
-            failedMailboxes: r.failedMailboxes
+            failedMailboxes: r.failedMailboxes,
+            failedMailboxReasons: r.failedMailboxReasons
           });
         }
         const fan = await fanOutImapMessages(imapArgs, "search");
@@ -88548,7 +88575,8 @@ ${r.text}`, {
           messages: r.messages,
           count: r.count,
           partial: r.partial,
-          failedMailboxes: r.failedMailboxes
+          failedMailboxes: r.failedMailboxes,
+          failedMailboxReasons: r.failedMailboxReasons
         });
       }
       const fan = await fanOutImapMessages({ subject: base, mailbox, limit }, "search");
@@ -88585,7 +88613,8 @@ ${r.text}`, {
         messages: orderedRows,
         count: orderedRows.length,
         partial: partial2,
-        failedMailboxes: fan.failedMailboxes
+        failedMailboxes: fan.failedMailboxes,
+        failedMailboxReasons: fan.failedMailboxReasons
       };
       if (orderedRows.length === 0) {
         return successResponse(`No messages found in thread "${base}".${coverage}`, structured2);
@@ -88649,7 +88678,8 @@ registerTool(
           messages: r.messages,
           count: r.count,
           partial: r.partial,
-          failedMailboxes: r.failedMailboxes
+          failedMailboxes: r.failedMailboxes,
+          failedMailboxReasons: r.failedMailboxReasons
         });
       }
       const fan = await fanOutImapMessages({ mailbox, limit, offset, from, unreadOnly }, "list");

package/package.json

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