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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sempervirens-labs/apple-mail-mcp",
-  "version": "1.3.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

@@ -116,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`
@@ -127,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}
 

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: [],
   },