gogcli-mcp-contacts 2.2.0 → 2.3.0

package/dist/index.js

@@ -31298,7 +31298,7 @@ var failIfNotEmptyParam = external_exports.boolean().optional().describe(
 );
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.2.0" : "0.0.0";
+var VERSION = true ? "2.3.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31358,6 +31358,129 @@ function registerExtraContactsTools(server2) {
     if (type) args.push(`--type=${type}`);
     return runOrDiagnose(args, { account });
   });
+  server2.registerTool("gog_contacts_update", {
+    description: "Update an existing Google Contact. Empty string clears a field; repeatable fields (url/address/custom/relation) take comma/semicolon-separated lists.",
+    inputSchema: {
+      resourceName: external_exports.string().describe("Contact resource name (people/...)"),
+      given: external_exports.string().optional().describe("Given (first) name"),
+      family: external_exports.string().optional().describe("Family (last) name"),
+      email: external_exports.string().optional().describe("Email address (empty string clears)"),
+      phone: external_exports.string().optional().describe("Phone number (empty string clears)"),
+      org: external_exports.string().optional().describe("Organization/company name (empty string clears)"),
+      title: external_exports.string().optional().describe("Job title (empty string clears)"),
+      url: external_exports.string().optional().describe("URL(s), comma-separated (empty string clears all)"),
+      note: external_exports.string().optional().describe("Note/biography (empty string clears)"),
+      address: external_exports.string().optional().describe("Postal address(es), semicolon-separated (empty string clears all)"),
+      birthday: external_exports.string().optional().describe("Birthday in YYYY-MM-DD (empty string clears)"),
+      ignoreEtag: external_exports.boolean().optional().describe("Allow update even if a supplied etag is stale (may overwrite concurrent changes)"),
+      account: accountParam
+    }
+  }, async ({ resourceName, given, family, email: email3, phone, org, title, url: url2, note, address, birthday, ignoreEtag, account }) => {
+    const args = ["contacts", "update", resourceName];
+    if (given !== void 0) args.push(`--given=${given}`);
+    if (family !== void 0) args.push(`--family=${family}`);
+    if (email3 !== void 0) args.push(`--email=${email3}`);
+    if (phone !== void 0) args.push(`--phone=${phone}`);
+    if (org !== void 0) args.push(`--org=${org}`);
+    if (title !== void 0) args.push(`--title=${title}`);
+    if (url2 !== void 0) args.push(`--url=${url2}`);
+    if (note !== void 0) args.push(`--note=${note}`);
+    if (address !== void 0) args.push(`--address=${address}`);
+    if (birthday !== void 0) args.push(`--birthday=${birthday}`);
+    if (ignoreEtag) args.push("--ignore-etag");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_delete", {
+    description: "Delete a Google Contact by resource name.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      resourceName: external_exports.string().describe("Contact resource name (people/...)"),
+      account: accountParam
+    }
+  }, async ({ resourceName, account }) => {
+    return runOrDiagnose(["contacts", "delete", resourceName], { account });
+  });
+  server2.registerTool("gog_contacts_export", {
+    description: "Export contacts as vCard (.vcf). Provide a selector (resource name, email, or name), or use query / all to export multiple.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      selector: external_exports.string().optional().describe("Contact resource name (people/...), email, or name"),
+      query: external_exports.string().optional().describe("Search query to export (max 30 results)"),
+      all: external_exports.boolean().optional().describe("Export all personal contacts"),
+      out: external_exports.string().optional().describe("Output path (.vcf), or - for stdout (default: stdout)"),
+      max: external_exports.number().optional().describe("Max results for query (1-30)"),
+      page: external_exports.string().optional().describe("Start page token for all"),
+      account: accountParam
+    }
+  }, async ({ selector, query, all, out, max, page, account }) => {
+    const args = ["contacts", "export"];
+    if (selector) args.push(selector);
+    if (query) args.push(`--query=${query}`);
+    if (all) args.push("--all");
+    if (out) args.push(`--out=${out}`);
+    if (max !== void 0) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_dedupe", {
+    description: "Find likely duplicate personal contacts (preview only \u2014 does not modify anything).",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      match: external_exports.string().optional().describe("Match fields, comma-separated from email,phone,name (default: email,phone)"),
+      max: external_exports.number().optional().describe("Max contacts to scan (0 = all)"),
+      account: accountParam
+    }
+  }, async ({ match, max, account }) => {
+    const args = ["contacts", "dedupe"];
+    if (match) args.push(`--match=${match}`);
+    if (max !== void 0) args.push(`--max=${max}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_directory_list", {
+    description: "List people from the Google Workspace directory (domain shared contacts).",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      max: external_exports.number().optional().describe("Max results (default: 50)"),
+      page: external_exports.string().optional().describe("Page token"),
+      all: external_exports.boolean().optional().describe("Fetch all pages"),
+      account: accountParam
+    }
+  }, async ({ max, page, all, account }) => {
+    const args = ["contacts", "directory", "list"];
+    if (max !== void 0) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push("--all");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_other_list", {
+    description: 'List "other contacts" \u2014 auto-collected addresses (e.g. people you have emailed) that are not in your saved contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      max: external_exports.number().optional().describe("Max results (default: 100)"),
+      page: external_exports.string().optional().describe("Page token"),
+      all: external_exports.boolean().optional().describe("Fetch all pages"),
+      account: accountParam
+    }
+  }, async ({ max, page, all, account }) => {
+    const args = ["contacts", "other", "list"];
+    if (max !== void 0) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push("--all");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_contacts_other_search", {
+    description: 'Search "other contacts" \u2014 auto-collected addresses not in your saved contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: external_exports.string().describe("Search query"),
+      max: external_exports.number().optional().describe("Max results (default: 50)"),
+      account: accountParam
+    }
+  }, async ({ query, max, account }) => {
+    const args = ["contacts", "other", "search", query];
+    if (max !== void 0) args.push(`--max=${max}`);
+    return runOrDiagnose(args, { account });
+  });
   server2.registerTool("gog_people_raw", {
     description: "Dump the raw People API response as JSON (lossless; for scripting and LLM consumption).",
     annotations: { readOnlyHint: true },

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-contacts",
   "display_name": "gogcli (Contacts)",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Extended Google Contacts for Claude via gogcli — auth + Contacts + Workspace directory (People API)",
   "author": {
     "name": "Chris Hall",
@@ -113,6 +113,34 @@
     {
       "name": "gog_people_raw",
       "description": "Dump raw People API JSON for a person"
+    },
+    {
+      "name": "gog_contacts_update",
+      "description": "Update an existing contact (empty string clears a field)"
+    },
+    {
+      "name": "gog_contacts_delete",
+      "description": "Delete a contact by resource name"
+    },
+    {
+      "name": "gog_contacts_export",
+      "description": "Export contacts as vCard (.vcf)"
+    },
+    {
+      "name": "gog_contacts_dedupe",
+      "description": "Find likely duplicate contacts (preview only)"
+    },
+    {
+      "name": "gog_contacts_directory_list",
+      "description": "List people from the Workspace directory"
+    },
+    {
+      "name": "gog_contacts_other_list",
+      "description": "List auto-collected other contacts"
+    },
+    {
+      "name": "gog_contacts_other_search",
+      "description": "Search auto-collected other contacts"
     }
   ],
   "compatibility": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-contacts",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "mcpName": "io.github.chrischall/gogcli-mcp-contacts",
   "description": "Extended Google Contacts + People MCP server via gogcli — auth + Contacts + Workspace directory (People API)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/src/tools/contacts-extra.ts

@@ -59,6 +59,136 @@ export function registerExtraContactsTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  server.registerTool('gog_contacts_update', {
+    description: 'Update an existing Google Contact. Empty string clears a field; repeatable fields (url/address/custom/relation) take comma/semicolon-separated lists.',
+    inputSchema: {
+      resourceName: z.string().describe('Contact resource name (people/...)'),
+      given: z.string().optional().describe('Given (first) name'),
+      family: z.string().optional().describe('Family (last) name'),
+      email: z.string().optional().describe('Email address (empty string clears)'),
+      phone: z.string().optional().describe('Phone number (empty string clears)'),
+      org: z.string().optional().describe('Organization/company name (empty string clears)'),
+      title: z.string().optional().describe('Job title (empty string clears)'),
+      url: z.string().optional().describe('URL(s), comma-separated (empty string clears all)'),
+      note: z.string().optional().describe('Note/biography (empty string clears)'),
+      address: z.string().optional().describe('Postal address(es), semicolon-separated (empty string clears all)'),
+      birthday: z.string().optional().describe('Birthday in YYYY-MM-DD (empty string clears)'),
+      ignoreEtag: z.boolean().optional().describe('Allow update even if a supplied etag is stale (may overwrite concurrent changes)'),
+      account: accountParam,
+    },
+  }, async ({ resourceName, given, family, email, phone, org, title, url, note, address, birthday, ignoreEtag, account }) => {
+    const args = ['contacts', 'update', resourceName];
+    if (given !== undefined) args.push(`--given=${given}`);
+    if (family !== undefined) args.push(`--family=${family}`);
+    if (email !== undefined) args.push(`--email=${email}`);
+    if (phone !== undefined) args.push(`--phone=${phone}`);
+    if (org !== undefined) args.push(`--org=${org}`);
+    if (title !== undefined) args.push(`--title=${title}`);
+    if (url !== undefined) args.push(`--url=${url}`);
+    if (note !== undefined) args.push(`--note=${note}`);
+    if (address !== undefined) args.push(`--address=${address}`);
+    if (birthday !== undefined) args.push(`--birthday=${birthday}`);
+    if (ignoreEtag) args.push('--ignore-etag');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_delete', {
+    description: 'Delete a Google Contact by resource name.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      resourceName: z.string().describe('Contact resource name (people/...)'),
+      account: accountParam,
+    },
+  }, async ({ resourceName, account }) => {
+    return runOrDiagnose(['contacts', 'delete', resourceName], { account });
+  });
+
+  server.registerTool('gog_contacts_export', {
+    description: 'Export contacts as vCard (.vcf). Provide a selector (resource name, email, or name), or use query / all to export multiple.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      selector: z.string().optional().describe('Contact resource name (people/...), email, or name'),
+      query: z.string().optional().describe('Search query to export (max 30 results)'),
+      all: z.boolean().optional().describe('Export all personal contacts'),
+      out: z.string().optional().describe('Output path (.vcf), or - for stdout (default: stdout)'),
+      max: z.number().optional().describe('Max results for query (1-30)'),
+      page: z.string().optional().describe('Start page token for all'),
+      account: accountParam,
+    },
+  }, async ({ selector, query, all, out, max, page, account }) => {
+    const args = ['contacts', 'export'];
+    if (selector) args.push(selector);
+    if (query) args.push(`--query=${query}`);
+    if (all) args.push('--all');
+    if (out) args.push(`--out=${out}`);
+    if (max !== undefined) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_dedupe', {
+    description: 'Find likely duplicate personal contacts (preview only — does not modify anything).',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      match: z.string().optional().describe('Match fields, comma-separated from email,phone,name (default: email,phone)'),
+      max: z.number().optional().describe('Max contacts to scan (0 = all)'),
+      account: accountParam,
+    },
+  }, async ({ match, max, account }) => {
+    const args = ['contacts', 'dedupe'];
+    if (match) args.push(`--match=${match}`);
+    if (max !== undefined) args.push(`--max=${max}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_directory_list', {
+    description: 'List people from the Google Workspace directory (domain shared contacts).',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      max: z.number().optional().describe('Max results (default: 50)'),
+      page: z.string().optional().describe('Page token'),
+      all: z.boolean().optional().describe('Fetch all pages'),
+      account: accountParam,
+    },
+  }, async ({ max, page, all, account }) => {
+    const args = ['contacts', 'directory', 'list'];
+    if (max !== undefined) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push('--all');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_other_list', {
+    description: 'List "other contacts" — auto-collected addresses (e.g. people you have emailed) that are not in your saved contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      max: z.number().optional().describe('Max results (default: 100)'),
+      page: z.string().optional().describe('Page token'),
+      all: z.boolean().optional().describe('Fetch all pages'),
+      account: accountParam,
+    },
+  }, async ({ max, page, all, account }) => {
+    const args = ['contacts', 'other', 'list'];
+    if (max !== undefined) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push('--all');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_other_search', {
+    description: 'Search "other contacts" — auto-collected addresses not in your saved contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: z.string().describe('Search query'),
+      max: z.number().optional().describe('Max results (default: 50)'),
+      account: accountParam,
+    },
+  }, async ({ query, max, account }) => {
+    const args = ['contacts', 'other', 'search', query];
+    if (max !== undefined) args.push(`--max=${max}`);
+    return runOrDiagnose(args, { account });
+  });
+
   server.registerTool('gog_people_raw', {
     description: 'Dump the raw People API response as JSON (lossless; for scripting and LLM consumption).',
     annotations: { readOnlyHint: true },

package/tests/tools/contacts-extra.test.ts

@@ -73,6 +73,148 @@ describe('gog_people_relations', () => {
   });
 });
 
+describe('gog_contacts_update', () => {
+  it('calls runOrDiagnose with just resourceName', async () => {
+    await handlers.get('gog_contacts_update')!({ resourceName: 'people/c1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'update', 'people/c1'], { account: undefined });
+  });
+
+  it('passes all fields including empty-string clears', async () => {
+    await handlers.get('gog_contacts_update')!({
+      resourceName: 'people/c1',
+      given: 'Ada',
+      family: 'Lovelace',
+      email: '',
+      phone: '+1',
+      org: 'Analytical',
+      title: 'Engineer',
+      url: 'https://a.com',
+      note: 'hi',
+      address: '1 St;City',
+      birthday: '1815-12-10',
+      ignoreEtag: true,
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      [
+        'contacts', 'update', 'people/c1',
+        '--given=Ada', '--family=Lovelace', '--email=', '--phone=+1',
+        '--org=Analytical', '--title=Engineer', '--url=https://a.com',
+        '--note=hi', '--address=1 St;City', '--birthday=1815-12-10', '--ignore-etag',
+      ],
+      { account: undefined },
+    );
+  });
+
+  it('omits --ignore-etag when false', async () => {
+    await handlers.get('gog_contacts_update')!({ resourceName: 'people/c1', ignoreEtag: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'update', 'people/c1'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_delete', () => {
+  it('calls runOrDiagnose with resourceName', async () => {
+    await handlers.get('gog_contacts_delete')!({ resourceName: 'people/c1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'delete', 'people/c1'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_export', () => {
+  it('calls runOrDiagnose with no options', async () => {
+    await handlers.get('gog_contacts_export')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'export'], { account: undefined });
+  });
+
+  it('passes selector and all flags', async () => {
+    await handlers.get('gog_contacts_export')!({
+      selector: 'people/c1',
+      query: 'ada',
+      all: true,
+      out: 'out.vcf',
+      max: 10,
+      page: 'tok',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'export', 'people/c1', '--query=ada', '--all', '--out=out.vcf', '--max=10', '--page=tok'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --all when false', async () => {
+    await handlers.get('gog_contacts_export')!({ all: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'export'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_dedupe', () => {
+  it('calls runOrDiagnose with no options', async () => {
+    await handlers.get('gog_contacts_dedupe')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'dedupe'], { account: undefined });
+  });
+
+  it('passes --match and --max', async () => {
+    await handlers.get('gog_contacts_dedupe')!({ match: 'name', max: 100 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'dedupe', '--match=name', '--max=100'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_contacts_directory_list', () => {
+  it('calls runOrDiagnose with no options', async () => {
+    await handlers.get('gog_contacts_directory_list')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'directory', 'list'], { account: undefined });
+  });
+
+  it('passes pagination flags', async () => {
+    await handlers.get('gog_contacts_directory_list')!({ max: 50, page: 'tok', all: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'directory', 'list', '--max=50', '--page=tok', '--all'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --all when false', async () => {
+    await handlers.get('gog_contacts_directory_list')!({ all: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'directory', 'list'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_other_list', () => {
+  it('calls runOrDiagnose with no options', async () => {
+    await handlers.get('gog_contacts_other_list')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'other', 'list'], { account: undefined });
+  });
+
+  it('passes pagination flags', async () => {
+    await handlers.get('gog_contacts_other_list')!({ max: 100, page: 'tok', all: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'other', 'list', '--max=100', '--page=tok', '--all'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --all when false', async () => {
+    await handlers.get('gog_contacts_other_list')!({ all: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'other', 'list'], { account: undefined });
+  });
+});
+
+describe('gog_contacts_other_search', () => {
+  it('calls runOrDiagnose with query', async () => {
+    await handlers.get('gog_contacts_other_search')!({ query: 'ada' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['contacts', 'other', 'search', 'ada'], { account: undefined });
+  });
+
+  it('passes --max when provided', async () => {
+    await handlers.get('gog_contacts_other_search')!({ query: 'ada', max: 25 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['contacts', 'other', 'search', 'ada', '--max=25'],
+      { account: undefined },
+    );
+  });
+});
+
 describe('gog_people_raw', () => {
   it('calls runOrDiagnose with userId', async () => {
     await handlers.get('gog_people_raw')!({ userId: 'people/c123' });