@aernoud/contactsmcp 0.1.1 → 0.2.0

package/dist/index.js

@@ -8,6 +8,12 @@ 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";
 const server = new McpServer({
     name: "contactsmcp",
     version: "0.1.0",
@@ -66,5 +72,47 @@ 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) }] };
+});
 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/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/package.json

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