@sempervirens-labs/apple-mail-mcp 1.1.0 → 1.3.0

package/.claude/settings.local.json

@@ -9,7 +9,10 @@
       "Bash(osascript:*)",
       "Bash(npm publish:*)",
       "Bash(bun run build)",
-      "Bash(npx tsc:*)"
+      "Bash(npx tsc:*)",
+      "Bash(git push:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)"
     ]
   }
 }

package/README.md

@@ -169,6 +169,9 @@ Get recent emails from a mailbox.
       "id": 12345,
       "subject": "Meeting tomorrow",
       "sender": "John Doe <john@example.com>",
+      "to": ["you@example.com", "team@example.com"],
+      "cc": ["manager@example.com"],
+      "bcc": [],
       "dateSent": "Monday, 10. January 2025 at 09:30:00",
       "isRead": false
     }
@@ -234,6 +237,7 @@ Archive an email by moving it to the Archive mailbox.
 | `messageId` | number | **Yes** | - | Email ID (from mail_get_emails or mail_search) |
 | `account` | string | No | - | Account name |
 | `mailbox` | string | No | "INBOX" | Current mailbox of the email |
+| `archiveMailbox` | string | No | auto-detect | Name of the archive folder (auto-detects "Archive", "Archives", or "All Mail") |
 
 **Example response:**
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sempervirens-labs/apple-mail-mcp",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "MCP server for Apple Mail - list accounts, mailboxes, search emails, and send messages",
   "type": "module",
   "main": "src/index.ts",

package/src/applescript/mail.ts

@@ -100,6 +100,9 @@ export interface Email {
   id: number;
   subject: string;
   sender: string;
+  to: string[];
+  cc: string[];
+  bcc: string[];
   dateSent: string;
   isRead: boolean;
   content?: string;
@@ -142,7 +145,26 @@ tell application "Mail"
             set msgRead to read status of msg
             ${contentPart}
 
-            set results to results & msgId & "<<>>" & msgSubject & "<<>>" & msgSender & "<<>>" & (msgDate as string) & "<<>>" & msgRead & "<<>>" & msgContent & "|||"
+            -- Get recipients
+            set toList to ""
+            repeat with r in to recipients of msg
+                set toList to toList & address of r & ","
+            end repeat
+            if toList is not "" then set toList to text 1 thru -2 of toList
+
+            set ccList to ""
+            repeat with r in cc recipients of msg
+                set ccList to ccList & address of r & ","
+            end repeat
+            if ccList is not "" then set ccList to text 1 thru -2 of ccList
+
+            set bccList to ""
+            repeat with r in bcc recipients of msg
+                set bccList to bccList & address of r & ","
+            end repeat
+            if bccList is not "" then set bccList to text 1 thru -2 of bccList
+
+            set results to results & msgId & "<<>>" & msgSubject & "<<>>" & msgSender & "<<>>" & toList & "<<>>" & ccList & "<<>>" & bccList & "<<>>" & (msgDate as string) & "<<>>" & msgRead & "<<>>" & msgContent & "|||"
         end repeat
     on error errMsg
         return "ERROR:" & errMsg
@@ -161,11 +183,14 @@ end tell
   const parts = result.split("|||").filter(Boolean);
 
   for (const part of parts) {
-    const [id, subject, sender, dateSent, isRead, content] = part.split("<<>>");
+    const [id, subject, sender, to, cc, bcc, dateSent, isRead, content] = part.split("<<>>");
     emails.push({
       id: parseInt(id) || 0,
       subject: subject || "(No Subject)",
       sender: sender || "(Unknown)",
+      to: to ? to.split(",").map(s => s.trim()).filter(Boolean) : [],
+      cc: cc ? cc.split(",").map(s => s.trim()).filter(Boolean) : [],
+      bcc: bcc ? bcc.split(",").map(s => s.trim()).filter(Boolean) : [],
       dateSent: dateSent || "",
       isRead: isRead === "true",
       content: content || undefined,
@@ -219,7 +244,26 @@ tell application "Mail"
                 set msgDate to date sent of msg
                 set msgRead to read status of msg
 
-                set results to results & msgId & "<<>>" & msgSubject & "<<>>" & msgSender & "<<>>" & (msgDate as string) & "<<>>" & msgRead & "|||"
+                -- Get recipients
+                set toList to ""
+                repeat with r in to recipients of msg
+                    set toList to toList & address of r & ","
+                end repeat
+                if toList is not "" then set toList to text 1 thru -2 of toList
+
+                set ccList to ""
+                repeat with r in cc recipients of msg
+                    set ccList to ccList & address of r & ","
+                end repeat
+                if ccList is not "" then set ccList to text 1 thru -2 of ccList
+
+                set bccList to ""
+                repeat with r in bcc recipients of msg
+                    set bccList to bccList & address of r & ","
+                end repeat
+                if bccList is not "" then set bccList to text 1 thru -2 of bccList
+
+                set results to results & msgId & "<<>>" & msgSubject & "<<>>" & msgSender & "<<>>" & toList & "<<>>" & ccList & "<<>>" & bccList & "<<>>" & (msgDate as string) & "<<>>" & msgRead & "|||"
                 set foundCount to foundCount + 1
             end repeat
         end repeat
@@ -240,11 +284,14 @@ end tell
   const parts = result.split("|||").filter(Boolean);
 
   for (const part of parts) {
-    const [id, subject, sender, dateSent, isRead] = part.split("<<>>");
+    const [id, subject, sender, to, cc, bcc, dateSent, isRead] = part.split("<<>>");
     emails.push({
       id: parseInt(id) || 0,
       subject: subject || "(No Subject)",
       sender: sender || "(Unknown)",
+      to: to ? to.split(",").map(s => s.trim()).filter(Boolean) : [],
+      cc: cc ? cc.split(",").map(s => s.trim()).filter(Boolean) : [],
+      bcc: bcc ? bcc.split(",").map(s => s.trim()).filter(Boolean) : [],
       dateSent: dateSent || "",
       isRead: isRead === "true",
     });
@@ -362,32 +409,49 @@ export function archiveEmail(options: {
   messageId: number;
   account?: string;
   mailbox?: string;
+  archiveMailbox?: string;
 }): { success: boolean; message: string } {
-  const { messageId, account, mailbox = "INBOX" } = options;
+  const { messageId, account, mailbox = "INBOX", archiveMailbox: customArchiveMailbox } = options;
 
   const accountPart = account
     ? `mailbox "${mailbox}" of account "${account}"`
     : `mailbox "${mailbox}"`;
 
-  const script = `
-tell application "Mail"
-    try
-        set theMailbox to ${accountPart}
-        set theMessage to (first message of theMailbox whose id is ${messageId})
-        set theAccount to account of theMailbox
+  // If a custom archive mailbox is specified, use it directly
+  const archiveLogic = customArchiveMailbox
+    ? `
+        set archiveMailbox to missing value
+        repeat with mb in mailboxes of theAccount
+            if name of mb is "${customArchiveMailbox}" then
+                set archiveMailbox to mb
+                exit repeat
+            end if
+        end repeat
 
-        -- Find the Archive mailbox for this account
+        if archiveMailbox is missing value then
+            return "ERROR:Archive mailbox '${customArchiveMailbox}' not found for this account"
+        end if`
+    : `
+        -- Find the Archive mailbox for this account (try common names)
         set archiveMailbox to missing value
         repeat with mb in mailboxes of theAccount
-            if name of mb is "Archive" or name of mb is "All Mail" then
+            if name of mb is "Archive" or name of mb is "Archives" or name of mb is "All Mail" then
                 set archiveMailbox to mb
                 exit repeat
             end if
         end repeat
 
         if archiveMailbox is missing value then
-            return "ERROR:No Archive mailbox found for this account"
-        end if
+            return "ERROR:No Archive mailbox found for this account. Try specifying archiveMailbox parameter with the exact folder name."
+        end if`;
+
+  const script = `
+tell application "Mail"
+    try
+        set theMailbox to ${accountPart}
+        set theMessage to (first message of theMailbox whose id is ${messageId})
+        set theAccount to account of theMailbox
+        ${archiveLogic}
 
         move theMessage to archiveMailbox
         return "Message archived successfully"

package/src/index.ts

@@ -163,6 +163,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           messageId,
           account: args?.account as string | undefined,
           mailbox: (args?.mailbox as string) || "INBOX",
+          archiveMailbox: args?.archiveMailbox as string | undefined,
         });
 
         return {

package/src/tools.ts

@@ -165,6 +165,10 @@ export const MAIL_ARCHIVE: Tool = {
         description: "The name of the mailbox/folder where the email currently is (default: INBOX)",
         default: "INBOX",
       },
+      archiveMailbox: {
+        type: "string",
+        description: "The name of the archive mailbox to move the email to (default: auto-detects 'Archive', 'Archives', or 'All Mail')",
+      },
     },
     required: ["messageId"],
   },