gogcli-mcp 2.2.0 → 2.4.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-    "version": "2.2.0"
+    "version": "2.4.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli",
       "source": "./",
       "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-      "version": "2.2.0",
+      "version": "2.4.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp",
   "displayName": "gogcli",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/dist/index.js

@@ -31961,11 +31961,13 @@ function registerGmailTools(server2) {
     inputSchema: {
       query: external_exports.string().describe("Gmail search query"),
       max: external_exports.number().int().optional().describe("Max results to return (default: 10)"),
+      fromContact: external_exports.string().optional().describe("Resolve a Google Contact (name or email) to its addresses and AND a from:(addr OR addr) clause onto the query \u2014 saves looking the contact up first when you only know who, not which address."),
       account: accountParam
     }
-  }, async ({ query, max, account }) => {
+  }, async ({ query, max, fromContact, account }) => {
     const args = ["gmail", "search", query];
     if (max !== void 0) args.push(`--max=${max}`);
+    if (fromContact) args.push(`--from-contact=${fromContact}`);
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_gmail_get", {
@@ -32322,7 +32324,7 @@ function registerTasksTools(server2) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.2.0" : "0.0.0";
+var VERSION = true ? "2.4.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",

package/dist/lib.js

@@ -30859,6 +30859,7 @@ var EMPTY_COMPLETION_RESULT = {
 import { spawn } from "node:child_process";
 import { delimiter } from "node:path";
 var TIMEOUT_MS = 3e4;
+var MIN_GOG_VERSION = "0.20.0";
 function envOrUndefined(key) {
   const value = process.env[key];
   if (!value || value.startsWith("${")) return void 0;
@@ -31873,11 +31874,13 @@ function registerGmailTools(server) {
     inputSchema: {
       query: external_exports.string().describe("Gmail search query"),
       max: external_exports.number().int().optional().describe("Max results to return (default: 10)"),
+      fromContact: external_exports.string().optional().describe("Resolve a Google Contact (name or email) to its addresses and AND a from:(addr OR addr) clause onto the query \u2014 saves looking the contact up first when you only know who, not which address."),
       account: accountParam
     }
-  }, async ({ query, max, account }) => {
+  }, async ({ query, max, fromContact, account }) => {
     const args = ["gmail", "search", query];
     if (max !== void 0) args.push(`--max=${max}`);
+    if (fromContact) args.push(`--from-contact=${fromContact}`);
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_gmail_get", {
@@ -32234,7 +32237,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.2.0" : "0.0.0";
+var VERSION = true ? "2.4.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -32256,6 +32259,7 @@ function createBaseServer(options) {
   return server;
 }
 export {
+  MIN_GOG_VERSION,
   VERSION,
   accountParam,
   createBaseServer,

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "mcpName": "io.github.chrischall/gogcli-mcp",
   "description": "MCP server wrapping gogcli for Google service access",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -7,12 +7,12 @@
     "source": "github",
     "subfolder": "packages/gogcli-mcp"
   },
-  "version": "2.2.0",
+  "version": "2.4.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp",
-      "version": "2.2.0",
+      "version": "2.4.0",
       "transport": {
         "type": "stdio"
       },

package/src/lib.ts

@@ -13,7 +13,7 @@ export {
   registerSlidesTools,
   registerTasksTools,
 } from './server.js';
-export { run } from './runner.js';
+export { run, MIN_GOG_VERSION } from './runner.js';
 export type { RunOptions, Spawner } from './runner.js';
 export {
   accountParam,

package/src/runner.ts

@@ -17,6 +17,14 @@ export interface RunOptions {
 
 const TIMEOUT_MS = 30_000;
 
+// Minimum gogcli (`gog`) binary version this wrapper's tools assume. Some tools
+// pass flags/subcommands that only exist in newer gog, so bump this whenever a
+// change starts relying on a newer gog feature — and label that PR `gogcli-bump`
+// so the requirement change is surfaced in the release notes (see
+// .github/release.yml). This is the single source of truth for the required
+// version; keep the README/CLAUDE.md mention in sync.
+export const MIN_GOG_VERSION = '0.20.0';
+
 // Treat unresolved .mcpb placeholders ("${user_config.gog_path}") and empty
 // strings the same as an unset env var. When an optional .mcpb user_config
 // field is left blank, some clients pass the literal placeholder text through

package/src/tools/gmail.ts

@@ -9,11 +9,13 @@ export function registerGmailTools(server: McpServer): void {
     inputSchema: {
       query: z.string().describe('Gmail search query'),
       max: z.number().int().optional().describe('Max results to return (default: 10)'),
+      fromContact: z.string().optional().describe('Resolve a Google Contact (name or email) to its addresses and AND a from:(addr OR addr) clause onto the query — saves looking the contact up first when you only know who, not which address.'),
       account: accountParam,
     },
-  }, async ({ query, max, account }) => {
+  }, async ({ query, max, fromContact, account }) => {
     const args = ['gmail', 'search', query];
     if (max !== undefined) args.push(`--max=${max}`);
+    if (fromContact) args.push(`--from-contact=${fromContact}`);
     return runOrDiagnose(args, { account });
   });
 

package/tests/tools/gmail.test.ts

@@ -30,6 +30,13 @@ describe('gog_gmail_search', () => {
     const result = await handlers.get('gog_gmail_search')!({ query: 'test' });
     expect(result.content[0].text).toBe('Error: Search failed');
   });
+
+  it('appends --from-contact flag when provided', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const handlers = setupHandlers();
+    await handlers.get('gog_gmail_search')!({ query: 'subject:invoice', fromContact: 'Alice' });
+    expect(runner.run).toHaveBeenCalledWith(['gmail', 'search', 'subject:invoice', '--from-contact=Alice'], { account: undefined });
+  });
 });
 
 describe('gog_gmail_get', () => {