@zyx1121/apple-mail-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zyx1121
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# @zyx1121/apple-mail-mcp
+
+MCP server for Apple Mail — read, search, and manage emails via Claude Code.
+
+## Install
+
+```bash
+claude mcp add apple-mail -- npx @zyx1121/apple-mail-mcp
+```
+
+## Prerequisites
+
+- macOS with Apple Mail configured
+- Node.js >= 18
+- First run will prompt for Automation permission (System Settings > Privacy & Security > Automation)
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `mail_get_accounts` | List all accounts and their mailboxes |
+| `mail_count_unread` | Count unread messages per account/mailbox |
+| `mail_list_messages` | List messages with filters (account, mailbox, date range, unread) |
+| `mail_read_message` | Read full content of a message by ID |
+| `mail_search` | Search by subject, sender, or both |
+| `mail_mark_read` | Mark a message as read |
+
+## Examples
+
+```
+"List my mail accounts"         → mail_get_accounts
+"Show unread count"             → mail_count_unread
+"Yesterday's emails"            → mail_list_messages { date_from: "2026-03-26" }
+"Search for GitHub emails"      → mail_search { query: "GitHub" }
+"Read message 12345"            → mail_read_message { message_id: 12345 }
+```
+
+## Limitations
+
+- macOS only (uses AppleScript via `osascript`)
+- Subject search is case-sensitive (AppleScript limitation)
+- Sender/body search fetches recent messages and filters in JS (last 30 days, max 500)
+- Mail.app must be running
+
+## License
+
+MIT

package/dist/applescript.d.ts

@@ -0,0 +1,5 @@
+export declare class AppleMailError extends Error {
+    constructor(message: string);
+}
+export declare function runAppleScript(script: string): Promise<string>;
+export declare function escapeForAppleScript(str: string): string;

package/dist/applescript.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+const TIMEOUT_MS = 15_000;
+export class AppleMailError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AppleMailError";
+    }
+}
+export async function runAppleScript(script) {
+    return new Promise((resolve, reject) => {
+        execFile("osascript", ["-e", script], { timeout: TIMEOUT_MS }, (err, stdout, stderr) => {
+            if (err) {
+                const msg = stderr || err.message;
+                if (msg.includes("not running") || msg.includes("-600"))
+                    return reject(new AppleMailError("Apple Mail is not running. Please open Mail.app and try again."));
+                if (msg.includes("not allowed") || msg.includes("not permitted"))
+                    return reject(new AppleMailError("Permission denied. Grant automation access in System Settings > Privacy & Security > Automation."));
+                if (msg.includes("timed out") || err.code === "ETIMEDOUT")
+                    return reject(new AppleMailError("AppleScript execution timed out."));
+                return reject(new AppleMailError(msg.trim()));
+            }
+            resolve(stdout.trimEnd());
+        });
+    });
+}
+export function escapeForAppleScript(str) {
+    return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+//# sourceMappingURL=applescript.js.map

package/dist/applescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applescript.js","sourceRoot":"","sources":["../src/applescript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACrF,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,GAAG,GAAG,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC;gBAClC,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACrD,OAAO,MAAM,CAAC,IAAI,cAAc,CAAC,gEAAgE,CAAC,CAAC,CAAC;gBACtG,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC;oBAC9D,OAAO,MAAM,CAAC,IAAI,cAAc,CAAC,kGAAkG,CAAC,CAAC,CAAC;gBACxI,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAK,GAA6B,CAAC,IAAI,KAAK,WAAW;oBAClF,OAAO,MAAM,CAAC,IAAI,cAAc,CAAC,kCAAkC,CAAC,CAAC,CAAC;gBACxE,OAAO,MAAM,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,19 @@
+export declare function success(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function error(message: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+export declare function withErrorHandling<T extends Record<string, unknown>>(fn: (args: T) => Promise<ReturnType<typeof success | typeof error>>): (args: T) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/helpers.js

@@ -0,0 +1,25 @@
+import { AppleMailError } from "./applescript.js";
+export function success(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+export function error(message) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+        isError: true,
+    };
+}
+export function withErrorHandling(fn) {
+    return async (args) => {
+        try {
+            return await fn(args);
+        }
+        catch (e) {
+            if (e instanceof AppleMailError)
+                return error(e.message);
+            throw e;
+        }
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,IAAa;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,EAAmE;IAEnE,OAAO,KAAK,EAAE,IAAO,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,cAAc;gBAAE,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACzD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+if (process.platform !== "darwin") {
+    console.error("apple-mail-mcp requires macOS with Apple Mail.");
+    process.exit(1);
+}
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,15 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerAccountTools } from "./tools/accounts.js";
+import { registerMessageTools } from "./tools/messages.js";
+import { registerSearchTools } from "./tools/search.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "apple-mail",
+        version: "0.1.0",
+    });
+    registerAccountTools(server);
+    registerMessageTools(server);
+    registerSearchTools(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/accounts.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAccountTools(server: McpServer): void;

package/dist/tools/accounts.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { runAppleScript } from "../applescript.js";
+import { success, withErrorHandling } from "../helpers.js";
+export function registerAccountTools(server) {
+    server.tool("mail_get_accounts", "List all mail accounts and their mailboxes", {}, withErrorHandling(async () => {
+        const accountNames = await runAppleScript(`tell application "Mail" to get name of every account`);
+        if (!accountNames)
+            return success([]);
+        const names = accountNames.split(", ");
+        const accounts = [];
+        for (const name of names) {
+            const mailboxes = await runAppleScript(`tell application "Mail" to get name of every mailbox of account "${name}"`);
+            accounts.push({
+                name,
+                mailboxes: mailboxes ? mailboxes.split(", ") : [],
+            });
+        }
+        return success(accounts);
+    }));
+    server.tool("mail_count_unread", "Count unread messages in a mailbox", {
+        account: z.string().optional().describe("Account name (e.g. 'iCloud', 'Gmail'). Omit for all accounts."),
+        mailbox: z.string().optional().describe("Mailbox name (e.g. 'INBOX'). Omit for inbox."),
+    }, withErrorHandling(async ({ account, mailbox }) => {
+        if (account) {
+            const target = mailbox
+                ? `mailbox "${mailbox}" of account "${account}"`
+                : `inbox`;
+            const count = await runAppleScript(`tell application "Mail" to get unread count of ${target}`);
+            return success({ account, mailbox: mailbox || "INBOX", unread: parseInt(count, 10) });
+        }
+        // All accounts
+        const accountNames = await runAppleScript(`tell application "Mail" to get name of every account`);
+        if (!accountNames)
+            return success([]);
+        const results = [];
+        for (const name of accountNames.split(", ")) {
+            const script = `
+tell application "Mail"
+  set acct to account "${name}"
+  set output to ""
+  repeat with mbox in every mailbox of acct
+    set cnt to unread count of mbox
+    if cnt > 0 then
+      set output to output & (name of mbox) & "\\t" & cnt & "\\n"
+    end if
+  end repeat
+  return output
+end tell`;
+            const raw = await runAppleScript(script);
+            if (!raw)
+                continue;
+            for (const line of raw.split("\n")) {
+                if (!line)
+                    continue;
+                const [mboxName, cnt] = line.split("\t");
+                results.push({ account: name, mailbox: mboxName, unread: parseInt(cnt, 10) });
+            }
+        }
+        return success(results);
+    }));
+}
+//# sourceMappingURL=accounts.js.map

package/dist/tools/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/tools/accounts.ts"],"names":[],"mappings":"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"}

package/dist/tools/messages.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMessageTools(server: McpServer): void;

package/dist/tools/messages.js

@@ -0,0 +1,160 @@
+import { z } from "zod";
+import { runAppleScript, escapeForAppleScript } from "../applescript.js";
+import { success, error, withErrorHandling } from "../helpers.js";
+function buildMailboxTarget(account, mailbox) {
+    if (account && mailbox)
+        return `mailbox "${mailbox}" of account "${account}"`;
+    if (account)
+        return `inbox of account "${account}"`;
+    return "inbox";
+}
+function formatDate(isoDate) {
+    const d = new Date(isoDate);
+    return d.toLocaleDateString("en-US", {
+        weekday: "long", year: "numeric", month: "long", day: "numeric",
+        hour: "numeric", minute: "numeric", second: "numeric",
+    });
+}
+function parseMessages(raw) {
+    if (!raw)
+        return [];
+    const messages = [];
+    for (const line of raw.split("\n")) {
+        if (!line)
+            continue;
+        const parts = line.split("\t");
+        if (parts.length < 5)
+            continue;
+        messages.push({
+            id: parseInt(parts[0], 10),
+            subject: parts[1],
+            sender: parts[2],
+            date: parts[3],
+            read: parts[4] === "true",
+        });
+    }
+    return messages;
+}
+export function registerMessageTools(server) {
+    server.tool("mail_list_messages", "List messages in a mailbox with optional filters", {
+        account: z.string().optional().describe("Account name"),
+        mailbox: z.string().optional().describe("Mailbox name (default: INBOX)"),
+        limit: z.number().int().positive().max(100).default(20).describe("Max messages to return"),
+        unread_only: z.boolean().default(false).describe("Only show unread messages"),
+        date_from: z.string().optional().describe("ISO 8601 date, e.g. '2026-03-26'"),
+        date_to: z.string().optional().describe("ISO 8601 date, e.g. '2026-03-27'"),
+    }, withErrorHandling(async ({ account, mailbox, limit, unread_only, date_from, date_to }) => {
+        const target = buildMailboxTarget(account, mailbox);
+        const conditions = [];
+        if (unread_only)
+            conditions.push("read status is false");
+        if (date_from)
+            conditions.push(`date received >= date "${formatDate(date_from)}"`);
+        if (date_to)
+            conditions.push(`date received <= date "${formatDate(date_to)}"`);
+        const whereClause = conditions.length > 0
+            ? ` whose ${conditions.join(" and ")}`
+            : "";
+        const script = `
+tell application "Mail"
+  set msgs to (every message of ${target}${whereClause})
+  set maxCount to ${limit}
+  if (count of msgs) < maxCount then set maxCount to (count of msgs)
+  set output to ""
+  repeat with i from 1 to maxCount
+    set m to item i of msgs
+    set output to output & (id of m) & "\\t" & (subject of m) & "\\t" & (sender of m) & "\\t" & (date received of m as string) & "\\t" & (read status of m) & "\\n"
+  end repeat
+  return output
+end tell`;
+        const raw = await runAppleScript(script);
+        return success(parseMessages(raw));
+    }));
+    server.tool("mail_read_message", "Read the full content of a specific message", {
+        message_id: z.number().int().describe("Message ID"),
+        account: z.string().optional().describe("Account name (speeds up lookup)"),
+        mailbox: z.string().optional().describe("Mailbox name (speeds up lookup)"),
+    }, withErrorHandling(async ({ message_id, account, mailbox }) => {
+        // If account and mailbox provided, direct lookup
+        if (account) {
+            const target = mailbox
+                ? `mailbox "${escapeForAppleScript(mailbox)}" of account "${escapeForAppleScript(account)}"`
+                : `inbox of account "${escapeForAppleScript(account)}"`;
+            const script = `
+tell application "Mail"
+  set m to message id ${message_id} of ${target}
+  set subj to subject of m
+  set sndr to sender of m
+  set rcvd to date received of m as string
+  set rd to read status of m
+  set cnt to content of m
+  set toList to address of every to recipient of m
+  set ccList to address of every cc recipient of m
+  return subj & "\\n===FIELD===\\n" & sndr & "\\n===FIELD===\\n" & rcvd & "\\n===FIELD===\\n" & rd & "\\n===FIELD===\\n" & cnt & "\\n===FIELD===\\n" & toList & "\\n===FIELD===\\n" & ccList
+end tell`;
+            const raw = await runAppleScript(script);
+            const fields = raw.split("\n===FIELD===\n");
+            return success({
+                id: message_id,
+                subject: fields[0] || "",
+                sender: fields[1] || "",
+                date: fields[2] || "",
+                read: fields[3] === "true",
+                content: fields[4] || "",
+                to: fields[5] || "",
+                cc: fields[6] || "",
+            });
+        }
+        // Scan all accounts' inboxes
+        const accountNames = await runAppleScript(`tell application "Mail" to get name of every account`);
+        if (!accountNames)
+            return error(`Message ${message_id} not found.`);
+        for (const acctName of accountNames.split(", ")) {
+            try {
+                const script = `
+tell application "Mail"
+  set m to message id ${message_id} of inbox of account "${acctName}"
+  set subj to subject of m
+  set sndr to sender of m
+  set rcvd to date received of m as string
+  set rd to read status of m
+  set cnt to content of m
+  set toList to address of every to recipient of m
+  set ccList to address of every cc recipient of m
+  return subj & "\\n===FIELD===\\n" & sndr & "\\n===FIELD===\\n" & rcvd & "\\n===FIELD===\\n" & rd & "\\n===FIELD===\\n" & cnt & "\\n===FIELD===\\n" & toList & "\\n===FIELD===\\n" & ccList
+end tell`;
+                const raw = await runAppleScript(script);
+                const fields = raw.split("\n===FIELD===\n");
+                return success({
+                    id: message_id,
+                    account: acctName,
+                    subject: fields[0] || "",
+                    sender: fields[1] || "",
+                    date: fields[2] || "",
+                    read: fields[3] === "true",
+                    content: fields[4] || "",
+                    to: fields[5] || "",
+                    cc: fields[6] || "",
+                });
+            }
+            catch {
+                continue; // Not in this account, try next
+            }
+        }
+        return error(`Message ${message_id} not found in any inbox.`);
+    }));
+    server.tool("mail_mark_read", "Mark a message as read", {
+        message_id: z.number().int().describe("Message ID"),
+        account: z.string().optional().describe("Account name"),
+        mailbox: z.string().optional().describe("Mailbox name"),
+    }, withErrorHandling(async ({ message_id, account, mailbox }) => {
+        const target = account
+            ? (mailbox
+                ? `mailbox "${escapeForAppleScript(mailbox)}" of account "${escapeForAppleScript(account)}"`
+                : `inbox of account "${escapeForAppleScript(account)}"`)
+            : "inbox";
+        await runAppleScript(`tell application "Mail" to set read status of message id ${message_id} of ${target} to true`);
+        return success({ message_id, marked_read: true });
+    }));
+}
+//# sourceMappingURL=messages.js.map

package/dist/tools/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"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"}

package/dist/tools/search.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchTools(server: McpServer): void;

package/dist/tools/search.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { runAppleScript, escapeForAppleScript } from "../applescript.js";
+import { success, withErrorHandling } from "../helpers.js";
+function parseMessages(raw) {
+    if (!raw)
+        return [];
+    const messages = [];
+    for (const line of raw.split("\n")) {
+        if (!line)
+            continue;
+        const parts = line.split("\t");
+        if (parts.length < 5)
+            continue;
+        messages.push({
+            id: parseInt(parts[0], 10),
+            subject: parts[1],
+            sender: parts[2],
+            date: parts[3],
+            read: parts[4] === "true",
+        });
+    }
+    return messages;
+}
+export function registerSearchTools(server) {
+    server.tool("mail_search", "Search messages by subject or sender", {
+        query: z.string().min(1).describe("Search keyword"),
+        field: z.enum(["subject", "sender", "all"]).default("all").describe("Field to search"),
+        account: z.string().optional().describe("Account name"),
+        mailbox: z.string().optional().describe("Mailbox name (default: INBOX)"),
+        limit: z.number().int().positive().max(50).default(10).describe("Max results"),
+    }, withErrorHandling(async ({ query, field, account, mailbox, limit }) => {
+        const escaped = escapeForAppleScript(query);
+        const target = account
+            ? (mailbox
+                ? `mailbox "${escapeForAppleScript(mailbox)}" of account "${escapeForAppleScript(account)}"`
+                : `inbox of account "${escapeForAppleScript(account)}"`)
+            : "inbox";
+        // Subject search: use native AppleScript filter
+        if (field === "subject") {
+            const script = `
+tell application "Mail"
+  set msgs to (every message of ${target} whose subject contains "${escaped}")
+  set maxCount to ${limit}
+  if (count of msgs) < maxCount then set maxCount to (count of msgs)
+  set output to ""
+  repeat with i from 1 to maxCount
+    set m to item i of msgs
+    set output to output & (id of m) & "\\t" & (subject of m) & "\\t" & (sender of m) & "\\t" & (date received of m as string) & "\\t" & (read status of m) & "\\n"
+  end repeat
+  return output
+end tell`;
+            return success(parseMessages(await runAppleScript(script)));
+        }
+        // Sender or all: fetch recent messages, filter in JS
+        const fetchLimit = 500;
+        const script = `
+tell application "Mail"
+  set thirtyDaysAgo to (current date) - 30 * days
+  set msgs to (every message of ${target} whose date received >= thirtyDaysAgo)
+  set maxCount to ${fetchLimit}
+  if (count of msgs) < maxCount then set maxCount to (count of msgs)
+  set output to ""
+  repeat with i from 1 to maxCount
+    set m to item i of msgs
+    set output to output & (id of m) & "\\t" & (subject of m) & "\\t" & (sender of m) & "\\t" & (date received of m as string) & "\\t" & (read status of m) & "\\n"
+  end repeat
+  return output
+end tell`;
+        const all = parseMessages(await runAppleScript(script));
+        const q = query.toLowerCase();
+        const filtered = all.filter((m) => {
+            if (field === "sender")
+                return m.sender.toLowerCase().includes(q);
+            // "all" — match subject or sender
+            return m.subject.toLowerCase().includes(q) || m.sender.toLowerCase().includes(q);
+        });
+        return success(filtered.slice(0, limit));
+    }));
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAU3D,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC/B,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YAChB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YACd,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,aAAa,EACb,sCAAsC,EACtC;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACnD,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACtF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACvD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;KAC/E,EACD,iBAAiB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QACpE,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO;YACpB,CAAC,CAAC,CAAC,OAAO;gBACR,CAAC,CAAC,YAAY,oBAAoB,CAAC,OAAO,CAAC,iBAAiB,oBAAoB,CAAC,OAAO,CAAC,GAAG;gBAC5F,CAAC,CAAC,qBAAqB,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC;YAC1D,CAAC,CAAC,OAAO,CAAC;QAEZ,gDAAgD;QAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG;;kCAEW,MAAM,4BAA4B,OAAO;oBACvD,KAAK;;;;;;;;SAQhB,CAAC;YACF,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,qDAAqD;QACrD,MAAM,UAAU,GAAG,GAAG,CAAC;QACvB,MAAM,MAAM,GAAG;;;kCAGa,MAAM;oBACpB,UAAU;;;;;;;;SAQrB,CAAC;QAEJ,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAE9B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,IAAI,KAAK,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClE,kCAAkC;YAClC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@zyx1121/apple-mail-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Apple Mail — read, search, and manage emails via Claude Code",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "apple-mail-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "apple-mail",
+    "claude",
+    "email",
+    "macos"
+  ],
+  "author": "zyx1121",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}