@zyx1121/apple-contacts-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 = 60_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-contacts-mcp requires macOS with Apple Contacts.");
+    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,wDAAwD,CAAC,CAAC;IACxE,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,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerContactTools } from "./tools/contacts.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "apple-contacts",
+        version: "0.1.0",
+    });
+    registerContactTools(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;AAE3D,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/contacts.d.ts

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

package/dist/tools/contacts.js

@@ -0,0 +1,239 @@
+import { z } from "zod";
+import { runAppleScript, escapeForAppleScript } from "../applescript.js";
+import { success, error, withErrorHandling } from "../helpers.js";
+const RS = "\u001e"; // ASCII 30 Record Separator
+function parseContact(line) {
+    const [id, name, firstName, lastName, org, phones, emails] = line.split("\t");
+    return {
+        id,
+        name,
+        firstName: firstName || null,
+        lastName: lastName || null,
+        organization: org || null,
+        phones: phones ? phones.split(",").filter(Boolean).map((p) => {
+            const [label, ...rest] = p.split(":");
+            return { label, value: rest.join(":") };
+        }) : [],
+        emails: emails ? emails.split(",").filter(Boolean).map((e) => {
+            const [label, ...rest] = e.split(":");
+            return { label, value: rest.join(":") };
+        }) : [],
+    };
+}
+function parseContacts(raw) {
+    if (!raw)
+        return [];
+    return raw.split(RS).filter(Boolean).map(parseContact);
+}
+const CONTACT_FIELDS = `
+    set phoneList to ""
+    repeat with ph in phones of p
+      set phoneList to phoneList & (label of ph) & ":" & (value of ph) & ","
+    end repeat
+    set emailList to ""
+    repeat with em in emails of p
+      set emailList to emailList & (label of em) & ":" & (value of em) & ","
+    end repeat
+    set fn to ""
+    try
+      if first name of p is not missing value then set fn to first name of p
+    end try
+    set ln to ""
+    try
+      if last name of p is not missing value then set ln to last name of p
+    end try
+    set org to ""
+    try
+      if organization of p is not missing value then set org to organization of p
+    end try`;
+export function registerContactTools(server) {
+    // List all contacts
+    server.registerTool("contacts_list", {
+        description: "List all contacts",
+        inputSchema: z.object({
+            limit: z.coerce.number().default(50).describe("Max contacts to return (default 50)"),
+        }),
+    }, withErrorHandling(async ({ limit }) => {
+        const raw = await runAppleScript(`
+tell application "Contacts"
+  set output to ""
+  set cnt to 0
+  repeat with p in every person
+    if cnt >= ${limit} then exit repeat
+    ${CONTACT_FIELDS}
+    set output to output & (id of p) & "\\t" & (name of p) & "\\t" & fn & "\\t" & ln & "\\t" & org & "\\t" & phoneList & "\\t" & emailList & (ASCII character 30)
+    set cnt to cnt + 1
+  end repeat
+  return output
+end tell`);
+        return success(parseContacts(raw));
+    }));
+    // Search contacts
+    server.registerTool("contacts_search", {
+        description: "Search contacts by name, phone, or email",
+        inputSchema: z.object({
+            query: z.string().min(1).describe("Search keyword"),
+        }),
+    }, withErrorHandling(async ({ query }) => {
+        const esc = escapeForAppleScript(query);
+        const raw = await runAppleScript(`
+tell application "Contacts"
+  set output to ""
+  set nameMatches to every person whose name contains "${esc}"
+  set emailMatches to every person whose emails contains "${esc}"
+  set phoneMatches to every person whose phones contains "${esc}"
+  set seen to {}
+  repeat with grp in {nameMatches, emailMatches, phoneMatches}
+    repeat with p in grp
+      set pid to id of p
+      if pid is not in seen then
+        set end of seen to pid
+        ${CONTACT_FIELDS}
+        set output to output & pid & "\\t" & (name of p) & "\\t" & fn & "\\t" & ln & "\\t" & org & "\\t" & phoneList & "\\t" & emailList & (ASCII character 30)
+      end if
+    end repeat
+  end repeat
+  return output
+end tell`);
+        return success(parseContacts(raw));
+    }));
+    // Get contact by ID
+    server.registerTool("contacts_get", {
+        description: "Get full details of a contact by ID",
+        inputSchema: z.object({
+            id: z.string().describe("Contact ID"),
+        }),
+    }, withErrorHandling(async ({ id }) => {
+        const esc = escapeForAppleScript(id);
+        const raw = await runAppleScript(`
+tell application "Contacts"
+  set p to person id "${esc}"
+  ${CONTACT_FIELDS}
+  set addrList to ""
+  repeat with a in addresses of p
+    set addrList to addrList & (label of a) & ":" & (street of a) & ";"
+  end repeat
+  set urlList to ""
+  repeat with u in urls of p
+    set urlList to urlList & (label of u) & ":" & (value of u) & ","
+  end repeat
+  set bd to ""
+  try
+    if birth date of p is not missing value then set bd to (birth date of p as string)
+  end try
+  return (id of p) & "\\t" & (name of p) & "\\t" & fn & "\\t" & ln & "\\t" & org & "\\t" & phoneList & "\\t" & emailList & "\\t" & addrList & "\\t" & urlList & "\\t" & bd
+end tell`);
+        if (!raw)
+            return error("Contact not found");
+        const parts = raw.split("\t");
+        const [cid, name, firstName, lastName, organization, phones, emails, addresses, urls, birthDate] = parts;
+        return success({
+            id: cid,
+            name,
+            firstName: firstName || null,
+            lastName: lastName || null,
+            organization: organization || null,
+            phones: phones ? phones.split(",").filter(Boolean).map((p) => {
+                const [label, ...rest] = p.split(":");
+                return { label, value: rest.join(":") };
+            }) : [],
+            emails: emails ? emails.split(",").filter(Boolean).map((e) => {
+                const [label, ...rest] = e.split(":");
+                return { label, value: rest.join(":") };
+            }) : [],
+            addresses: addresses ? addresses.split(";").filter(Boolean).map((a) => {
+                const [label, ...rest] = a.split(":");
+                return { label, street: rest.join(":") };
+            }) : [],
+            urls: urls ? urls.split(",").filter(Boolean).map((u) => {
+                const [label, ...rest] = u.split(":");
+                return { label, value: rest.join(":") };
+            }) : [],
+            birthDate: birthDate || null,
+        });
+    }));
+    // Create contact
+    server.registerTool("contacts_create", {
+        description: "Create a new contact",
+        inputSchema: z.object({
+            first_name: z.string().optional().describe("First name"),
+            last_name: z.string().optional().describe("Last name"),
+            organization: z.string().optional().describe("Company/organization"),
+            phone: z.string().optional().describe("Phone number"),
+            phone_label: z.string().default("mobile").describe("Phone label (mobile, home, work, etc.)"),
+            email: z.string().optional().describe("Email address"),
+            email_label: z.string().default("work").describe("Email label (work, home, etc.)"),
+        }),
+    }, withErrorHandling(async ({ first_name, last_name, organization, phone, phone_label, email, email_label }) => {
+        if (!first_name && !last_name && !organization)
+            return error("Provide at least first_name, last_name, or organization");
+        const props = [];
+        if (first_name)
+            props.push(`first name:"${escapeForAppleScript(first_name)}"`);
+        if (last_name)
+            props.push(`last name:"${escapeForAppleScript(last_name)}"`);
+        if (organization)
+            props.push(`organization:"${escapeForAppleScript(organization)}"`);
+        const phoneCmd = phone
+            ? `make new phone at end of phones of newPerson with properties {label:"${escapeForAppleScript(phone_label)}", value:"${escapeForAppleScript(phone)}"}`
+            : "";
+        const emailCmd = email
+            ? `make new email at end of emails of newPerson with properties {label:"${escapeForAppleScript(email_label)}", value:"${escapeForAppleScript(email)}"}`
+            : "";
+        const raw = await runAppleScript(`
+tell application "Contacts"
+  set newPerson to make new person with properties {${props.join(", ")}}
+  ${phoneCmd}
+  ${emailCmd}
+  save
+  return (id of newPerson) & "\\t" & (name of newPerson)
+end tell`);
+        const [id, name] = raw.split("\t");
+        return success({ id, name, created: true });
+    }));
+    // Update contact
+    server.registerTool("contacts_update", {
+        description: "Update an existing contact",
+        inputSchema: z.object({
+            id: z.string().describe("Contact ID"),
+            first_name: z.string().optional().describe("New first name"),
+            last_name: z.string().optional().describe("New last name"),
+            organization: z.string().optional().describe("New organization"),
+        }),
+    }, withErrorHandling(async ({ id, first_name, last_name, organization }) => {
+        const esc = escapeForAppleScript(id);
+        const updates = [];
+        if (first_name !== undefined)
+            updates.push(`set first name of p to "${escapeForAppleScript(first_name)}"`);
+        if (last_name !== undefined)
+            updates.push(`set last name of p to "${escapeForAppleScript(last_name)}"`);
+        if (organization !== undefined)
+            updates.push(`set organization of p to "${escapeForAppleScript(organization)}"`);
+        if (!updates.length)
+            return error("No fields to update");
+        await runAppleScript(`
+tell application "Contacts"
+  set p to person id "${esc}"
+  ${updates.join("\n  ")}
+  save
+end tell`);
+        return success({ id, updated: true });
+    }));
+    // Delete contact
+    server.registerTool("contacts_delete", {
+        description: "Delete a contact",
+        inputSchema: z.object({
+            id: z.string().describe("Contact ID"),
+        }),
+    }, withErrorHandling(async ({ id }) => {
+        const esc = escapeForAppleScript(id);
+        await runAppleScript(`
+tell application "Contacts"
+  set p to person id "${esc}"
+  delete p
+  save
+end tell`);
+        return success({ id, deleted: true });
+    }));
+}
+//# sourceMappingURL=contacts.js.map

package/dist/tools/contacts.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@zyx1121/apple-contacts-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Apple Contacts — search, read, create, and manage contacts via Claude Code",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "apple-contacts-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "apple-contacts",
+    "claude",
+    "contacts",
+    "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"
+  }
+}