@sempervirens-labs/apple-mail-mcp 1.2.0 → 1.4.0

package/.claude/settings.local.json

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

package/README.md

@@ -160,6 +160,7 @@ Get recent emails from a mailbox.
 | `mailbox` | string | No | "INBOX" | Mailbox name |
 | `limit` | number | No | 10 | Max emails to retrieve |
 | `includeContent` | boolean | No | false | Include email body |
+| `unreadOnly` | boolean | No | false | Only return unread emails |
 
 **Example response:**
 ```json
@@ -169,6 +170,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
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sempervirens-labs/apple-mail-mcp",
-  "version": "1.2.0",
+  "version": "1.4.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;
@@ -113,8 +116,9 @@ export function getEmails(options: {
   mailbox?: string;
   limit?: number;
   includeContent?: boolean;
+  unreadOnly?: boolean;
 }): Email[] {
-  const { account, mailbox = "INBOX", limit = 10, includeContent = false } = options;
+  const { account, mailbox = "INBOX", limit = 10, includeContent = false, unreadOnly = false } = options;
 
   const contentPart = includeContent
     ? `set msgContent to content of msg`
@@ -124,12 +128,17 @@ export function getEmails(options: {
     ? `mailbox "${mailbox}" of account "${account}"`
     : `mailbox "${mailbox}"`;
 
+  // If unreadOnly, filter messages by read status
+  const messageFilter = unreadOnly
+    ? `(messages of theMailbox whose read status is false)`
+    : `messages of theMailbox`;
+
   const script = `
 tell application "Mail"
     set results to ""
     try
         set theMailbox to ${accountPart}
-        set msgList to messages of theMailbox
+        set msgList to ${messageFilter}
         set msgCount to count of msgList
         if msgCount > ${limit} then set msgCount to ${limit}
 
@@ -142,7 +151,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 +189,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 +250,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 +290,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",
     });

package/src/index.ts

@@ -78,6 +78,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           mailbox: (args?.mailbox as string) || "INBOX",
           limit: (args?.limit as number) || 10,
           includeContent: (args?.includeContent as boolean) || false,
+          unreadOnly: (args?.unreadOnly as boolean) || false,
         });
         return {
           content: [

package/src/tools.ts

@@ -50,6 +50,11 @@ export const MAIL_GET_EMAILS: Tool = {
         description: "Whether to include the email body content (default: false)",
         default: false,
       },
+      unreadOnly: {
+        type: "boolean",
+        description: "Only return unread emails (default: false)",
+        default: false,
+      },
     },
     required: [],
   },