@aernoud/contactsmcp 0.2.0 → 0.3.0

package/dist/index.js

@@ -14,6 +14,9 @@ import { createGroup } from "./tools/createGroup.js";
 import { deleteGroup } from "./tools/deleteGroup.js";
 import { renameGroup } from "./tools/renameGroup.js";
 import { listGroupMembers } from "./tools/listGroupMembers.js";
+import { getMyCard } from "./tools/getMyCard.js";
+import { getVcard } from "./tools/getVcard.js";
+import { searchByModificationDate } from "./tools/searchByModificationDate.js";
 const server = new McpServer({
     name: "contactsmcp",
     version: "0.1.0",
@@ -114,5 +117,25 @@ server.tool("list-group-members", "List all contacts in a group in macOS Contact
     const members = await listGroupMembers(groupName, limit);
     return { content: [{ type: "text", text: JSON.stringify(members, null, 2) }] };
 });
+server.tool("get-my-card", "Get the user's own contact card from macOS Contacts.app", {}, async () => {
+    const card = await getMyCard();
+    return { content: [{ type: "text", text: JSON.stringify(card, null, 2) }] };
+});
+server.tool("get-vcard", "Get the vCard 3.0 text for a contact by their Contacts.app ID", {
+    contactId: z.string().describe("Contact ID from Contacts.app (from search results)"),
+}, async ({ contactId }) => {
+    const result = await getVcard(contactId);
+    if (!result) {
+        return { content: [{ type: "text", text: "Contact not found." }] };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("search-by-modification-date", "Find contacts modified after a given date in macOS Contacts.app", {
+    since: z.string().describe("Date string, e.g. 'January 1, 2026' or '2026-01-01'"),
+    limit: z.number().optional().default(50).describe("Max results to return"),
+}, async ({ since, limit }) => {
+    const contacts = await searchByModificationDate(since, limit);
+    return { content: [{ type: "text", text: JSON.stringify(contacts, null, 2) }] };
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/tools/getMyCard.d.ts

@@ -0,0 +1,7 @@
+export declare function getMyCard(): Promise<{
+    id: string;
+    name: string;
+    organization: string;
+    email: string;
+    phone: string;
+}>;

package/dist/tools/getMyCard.js

@@ -0,0 +1,31 @@
+import { runAppleScript, FIELD_SEP } from "@mailappmcp/shared";
+export async function getMyCard() {
+    const script = `
+tell application "Contacts"
+  set p to my card
+  set pId to id of p
+  set pName to name of p
+  set pEmail to ""
+  try
+    set pEmail to value of first email of p
+  end try
+  set pPhone to ""
+  try
+    set pPhone to value of first phone of p
+  end try
+  set pOrg to ""
+  try
+    set pOrg to organization of p
+  end try
+  return pId & "${FIELD_SEP}" & pName & "${FIELD_SEP}" & pOrg & "${FIELD_SEP}" & pEmail & "${FIELD_SEP}" & pPhone
+end tell`;
+    const raw = await runAppleScript(script);
+    const parts = raw.split(FIELD_SEP);
+    return {
+        id: (parts[0] ?? "").trim(),
+        name: (parts[1] ?? "").trim(),
+        organization: (parts[2] ?? "").trim(),
+        email: (parts[3] ?? "").trim(),
+        phone: (parts[4] ?? "").trim(),
+    };
+}

package/dist/tools/getVcard.d.ts

@@ -0,0 +1,3 @@
+export declare function getVcard(contactId: string): Promise<{
+    vcard: string;
+} | null>;

package/dist/tools/getVcard.js

@@ -0,0 +1,18 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function getVcard(contactId) {
+    const cId = escapeForAppleScript(contactId);
+    const script = `
+tell application "Contacts"
+  try
+    set p to first person whose id is "${cId}"
+    return vcard of p
+  on error
+    return "NOT_FOUND"
+  end try
+end tell`;
+    const raw = await runAppleScript(script);
+    if (raw.trim() === "NOT_FOUND") {
+        return null;
+    }
+    return { vcard: raw.trim() };
+}

package/dist/tools/searchByModificationDate.d.ts

@@ -0,0 +1,5 @@
+export declare function searchByModificationDate(since: string, limit: number): Promise<{
+    id: string;
+    name: string;
+    modificationDate: string;
+}[]>;

package/dist/tools/searchByModificationDate.js

@@ -0,0 +1,37 @@
+import { runAppleScript, escapeForAppleScript, FIELD_SEP, RECORD_SEP } from "@mailappmcp/shared";
+export async function searchByModificationDate(since, limit) {
+    const escapedDate = escapeForAppleScript(since);
+    const script = `
+tell application "Contacts"
+  set cutoffDate to date "${escapedDate}"
+  set output to ""
+  set i to 0
+  set maxLimit to ${limit}
+  repeat with p in every person
+    if i >= maxLimit then exit repeat
+    if modification date of p > cutoffDate then
+      set pId to id of p
+      set pName to name of p
+      set modDate to modification date of p as string
+      set output to output & pId & "${FIELD_SEP}" & pName & "${FIELD_SEP}" & modDate & "${RECORD_SEP}"
+      set i to i + 1
+    end if
+  end repeat
+  return output
+end tell`;
+    const raw = await runAppleScript(script);
+    if (!raw.trim()) {
+        return [];
+    }
+    return raw
+        .split(RECORD_SEP)
+        .filter((r) => r.trim())
+        .map((record) => {
+        const fields = record.split(FIELD_SEP);
+        return {
+            id: (fields[0] ?? "").trim(),
+            name: (fields[1] ?? "").trim(),
+            modificationDate: (fields[2] ?? "").trim(),
+        };
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aernoud/contactsmcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for macOS Contacts.app — contact management via AppleScript",
   "mcpName": "io.github.aernouddekker/contactsmcp",
   "type": "module",