@aernoud/contactsmcp 0.1.1 → 0.3.0

package/dist/index.js

@@ -8,6 +8,15 @@ import { createContact } from "./tools/createContact.js";
 import { updateContact } from "./tools/updateContact.js";
 import { listGroups } from "./tools/listGroups.js";
 import { addToGroup } from "./tools/addToGroup.js";
+import { removeFromGroup } from "./tools/removeFromGroup.js";
+import { deleteContact } from "./tools/deleteContact.js";
+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",
@@ -66,5 +75,67 @@ server.tool("add-to-group", "Add a contact to a group in macOS Contacts.app", {
     }
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
 });
+server.tool("remove-from-group", "Remove a contact from a group in macOS Contacts.app", {
+    contactId: z.string().describe("Contact ID from Contacts.app"),
+    groupName: z.string().describe("Name of the group to remove the contact from"),
+}, async ({ contactId, groupName }) => {
+    const result = await removeFromGroup(contactId, groupName);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("delete-contact", "Delete a contact from macOS Contacts.app", {
+    contactId: z.string().describe("Contact ID from Contacts.app"),
+}, async ({ contactId }) => {
+    const result = await deleteContact(contactId);
+    if (!result) {
+        return { content: [{ type: "text", text: "Contact not found." }] };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("create-group", "Create a new contact group in macOS Contacts.app", {
+    name: z.string().describe("Name for the new group"),
+}, async ({ name }) => {
+    const result = await createGroup(name);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("delete-group", "Delete a contact group from macOS Contacts.app", {
+    groupName: z.string().describe("Name of the group to delete"),
+}, async ({ groupName }) => {
+    const result = await deleteGroup(groupName);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("rename-group", "Rename a contact group in macOS Contacts.app", {
+    groupName: z.string().describe("Current name of the group"),
+    newName: z.string().describe("New name for the group"),
+}, async ({ groupName, newName }) => {
+    const result = await renameGroup(groupName, newName);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("list-group-members", "List all contacts in a group in macOS Contacts.app", {
+    groupName: z.string().describe("Name of the group"),
+    limit: z.number().optional().default(100).describe("Max members to return"),
+}, async ({ groupName, limit }) => {
+    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/createGroup.d.ts

@@ -0,0 +1,4 @@
+export declare function createGroup(name: string): Promise<{
+    id: string;
+    name: string;
+}>;

package/dist/tools/createGroup.js

@@ -0,0 +1,12 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function createGroup(name) {
+    const gName = escapeForAppleScript(name);
+    const script = `
+tell application "Contacts"
+  set newGroup to make new group with properties {name:"${gName}"}
+  save
+  return id of newGroup
+end tell`;
+    const id = (await runAppleScript(script)).trim();
+    return { id, name };
+}

package/dist/tools/deleteContact.d.ts

@@ -0,0 +1,4 @@
+export declare function deleteContact(contactId: string): Promise<{
+    success: boolean;
+    contactId: string;
+} | null>;

package/dist/tools/deleteContact.js

@@ -0,0 +1,21 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function deleteContact(contactId) {
+    const cId = escapeForAppleScript(contactId);
+    const script = `
+tell application "Contacts"
+  set personResults to (every person whose id is "${cId}")
+  if (count of personResults) = 0 then
+    return "CONTACT_NOT_FOUND"
+  end if
+  set p to item 1 of personResults
+  delete p
+  save
+  return "deleted"
+end tell`;
+    const result = await runAppleScript(script);
+    const trimmed = result.trim();
+    if (trimmed === "CONTACT_NOT_FOUND") {
+        return null;
+    }
+    return { success: true, contactId };
+}

package/dist/tools/deleteGroup.d.ts

@@ -0,0 +1,4 @@
+export declare function deleteGroup(groupName: string): Promise<{
+    success: boolean;
+    groupName: string;
+}>;

package/dist/tools/deleteGroup.js

@@ -0,0 +1,21 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function deleteGroup(groupName) {
+    const gName = escapeForAppleScript(groupName);
+    const script = `
+tell application "Contacts"
+  set groupResults to (every group whose name is "${gName}")
+  if (count of groupResults) = 0 then
+    return "GROUP_NOT_FOUND"
+  end if
+  set g to item 1 of groupResults
+  delete g
+  save
+  return "deleted"
+end tell`;
+    const result = await runAppleScript(script);
+    const trimmed = result.trim();
+    if (trimmed === "GROUP_NOT_FOUND") {
+        throw new Error(`Group not found: ${groupName}`);
+    }
+    return { success: true, groupName };
+}

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/listGroupMembers.d.ts

@@ -0,0 +1 @@
+export declare function listGroupMembers(groupName: string, limit?: number): Promise<Record<string, string>[]>;

package/dist/tools/listGroupMembers.js

@@ -0,0 +1,37 @@
+import { runAppleScript, escapeForAppleScript, parseRecords, FIELD_SEP, RECORD_SEP } from "@mailappmcp/shared";
+export async function listGroupMembers(groupName, limit = 100) {
+    const gName = escapeForAppleScript(groupName);
+    const maxCount = Math.floor(limit);
+    const script = `
+tell application "Contacts"
+  set groupResults to (every group whose name is "${gName}")
+  if (count of groupResults) = 0 then
+    return "GROUP_NOT_FOUND"
+  end if
+  set g to item 1 of groupResults
+  set output to ""
+  set i to 0
+  repeat with p in people of g
+    if i >= ${maxCount} then exit repeat
+    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 output to output & pId & "${FIELD_SEP}" & pName & "${FIELD_SEP}" & pEmail & "${FIELD_SEP}" & pPhone & "${RECORD_SEP}"
+    set i to i + 1
+  end repeat
+  return output
+end tell`;
+    const result = await runAppleScript(script);
+    const trimmed = result.trim();
+    if (trimmed === "GROUP_NOT_FOUND") {
+        throw new Error(`Group not found: ${groupName}`);
+    }
+    return parseRecords(trimmed, ["id", "name", "email", "phone"]);
+}

package/dist/tools/removeFromGroup.d.ts

@@ -0,0 +1,3 @@
+export declare function removeFromGroup(contactId: string, groupName: string): Promise<{
+    success: boolean;
+}>;

package/dist/tools/removeFromGroup.js

@@ -0,0 +1,30 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function removeFromGroup(contactId, groupName) {
+    const cId = escapeForAppleScript(contactId);
+    const gName = escapeForAppleScript(groupName);
+    const script = `
+tell application "Contacts"
+  set personResults to (every person whose id is "${cId}")
+  if (count of personResults) = 0 then
+    return "CONTACT_NOT_FOUND"
+  end if
+  set groupResults to (every group whose name is "${gName}")
+  if (count of groupResults) = 0 then
+    return "GROUP_NOT_FOUND"
+  end if
+  set p to item 1 of personResults
+  set g to item 1 of groupResults
+  remove p from g
+  save
+  return "done"
+end tell`;
+    const result = await runAppleScript(script);
+    const trimmed = result.trim();
+    if (trimmed === "CONTACT_NOT_FOUND") {
+        throw new Error(`Contact not found: ${contactId}`);
+    }
+    if (trimmed === "GROUP_NOT_FOUND") {
+        throw new Error(`Group not found: ${groupName}`);
+    }
+    return { success: true };
+}

package/dist/tools/renameGroup.d.ts

@@ -0,0 +1,5 @@
+export declare function renameGroup(groupName: string, newName: string): Promise<{
+    success: boolean;
+    oldName: string;
+    newName: string;
+}>;

package/dist/tools/renameGroup.js

@@ -0,0 +1,22 @@
+import { runAppleScript, escapeForAppleScript } from "@mailappmcp/shared";
+export async function renameGroup(groupName, newName) {
+    const gName = escapeForAppleScript(groupName);
+    const gNewName = escapeForAppleScript(newName);
+    const script = `
+tell application "Contacts"
+  set groupResults to (every group whose name is "${gName}")
+  if (count of groupResults) = 0 then
+    return "GROUP_NOT_FOUND"
+  end if
+  set g to item 1 of groupResults
+  set name of g to "${gNewName}"
+  save
+  return "renamed"
+end tell`;
+    const result = await runAppleScript(script);
+    const trimmed = result.trim();
+    if (trimmed === "GROUP_NOT_FOUND") {
+        throw new Error(`Group not found: ${groupName}`);
+    }
+    return { success: true, oldName: groupName, newName };
+}

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.1.1",
+  "version": "0.3.0",
   "description": "MCP server for macOS Contacts.app — contact management via AppleScript",
   "mcpName": "io.github.aernouddekker/contactsmcp",
   "type": "module",