gogcli-mcp-gmail 2.7.1 → 2.8.0

package/dist/index.js

@@ -31299,7 +31299,7 @@ var failIfNotEmptyParam = external_exports.boolean().optional().describe(
 );
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.7.1" : "0.0.0";
+var VERSION = true ? "2.8.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31403,7 +31403,8 @@ function registerExtraGmailTools(server2) {
     {
       tool: "gog_gmail_archive",
       cmd: "archive",
-      description: "Archive messages (remove from inbox). Pass either messageIds or a Gmail search query."
+      description: "Archive messages (remove from inbox). Pass either messageIds or a Gmail search query. Set thread=true to treat the ids as THREAD ids and archive every message in each thread (the right mode for ids that came from thread search).",
+      supportsThread: true
     },
     {
       tool: "gog_gmail_mark_read",
@@ -31421,21 +31422,27 @@ function registerExtraGmailTools(server2) {
       description: "Move messages to trash. Pass either messageIds or a Gmail search query."
     }
   ];
-  for (const { tool, cmd, description } of bulkActions) {
+  for (const { tool, cmd, description, supportsThread } of bulkActions) {
+    const inputSchema = {
+      messageIds: external_exports.array(external_exports.string()).optional().describe("Specific message IDs to act on"),
+      query: external_exports.string().optional().describe("Gmail search query (alternative to messageIds; acts on all matching)"),
+      max: external_exports.number().optional().describe("Max messages when using --query (default: 100)"),
+      account: accountParam
+    };
+    if (supportsThread) {
+      inputSchema.thread = external_exports.boolean().optional().describe("Treat messageIds as THREAD ids and act on every message in each thread");
+    }
     server2.registerTool(tool, {
       description,
       annotations: { destructiveHint: true },
-      inputSchema: {
-        messageIds: external_exports.array(external_exports.string()).optional().describe("Specific message IDs to act on"),
-        query: external_exports.string().optional().describe("Gmail search query (alternative to messageIds; acts on all matching)"),
-        max: external_exports.number().optional().describe("Max messages when using --query (default: 100)"),
-        account: accountParam
-      }
-    }, async ({ messageIds, query, max, account }) => {
+      inputSchema
+    }, async (rawArgs) => {
+      const { messageIds, query, max, thread, account } = rawArgs;
       const args = ["gmail", cmd];
       if (messageIds) args.push(...messageIds);
       if (query) args.push(`--query=${query}`);
       if (max !== void 0) args.push(`--max=${max}`);
+      if (supportsThread && thread) args.push("--thread");
       return runOrDiagnose(args, { account });
     });
   }

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-gmail",
   "display_name": "gogcli (Gmail)",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "description": "Extended Gmail for Claude via gogcli — auth + full Gmail support (threads, labels, drafts, attachments, forward, autoreply, bulk operations)",
   "author": {
     "name": "Chris Hall",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-gmail",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "mcpName": "io.github.chrischall/gogcli-mcp-gmail",
   "description": "Extended Gmail MCP server via gogcli — auth + full Gmail support (threads, labels, drafts, attachments, forward, autoreply, bulk operations)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/src/tools/gmail-extra.ts

@@ -122,11 +122,12 @@ export function registerExtraGmailTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
-  const bulkActions: Array<{ tool: string; cmd: string; description: string }> = [
+  const bulkActions: Array<{ tool: string; cmd: string; description: string; supportsThread?: boolean }> = [
     {
       tool: 'gog_gmail_archive',
       cmd: 'archive',
-      description: 'Archive messages (remove from inbox). Pass either messageIds or a Gmail search query.',
+      description: 'Archive messages (remove from inbox). Pass either messageIds or a Gmail search query. Set thread=true to treat the ids as THREAD ids and archive every message in each thread (the right mode for ids that came from thread search).',
+      supportsThread: true,
     },
     {
       tool: 'gog_gmail_mark_read',
@@ -145,21 +146,29 @@ export function registerExtraGmailTools(server: McpServer): void {
     },
   ];
 
-  for (const { tool, cmd, description } of bulkActions) {
+  for (const { tool, cmd, description, supportsThread } of bulkActions) {
+    const inputSchema: Record<string, z.ZodTypeAny> = {
+      messageIds: z.array(z.string()).optional().describe('Specific message IDs to act on'),
+      query: z.string().optional().describe('Gmail search query (alternative to messageIds; acts on all matching)'),
+      max: z.number().optional().describe('Max messages when using --query (default: 100)'),
+      account: accountParam,
+    };
+    if (supportsThread) {
+      inputSchema.thread = z.boolean().optional().describe('Treat messageIds as THREAD ids and act on every message in each thread');
+    }
     server.registerTool(tool, {
       description,
       annotations: { destructiveHint: true },
-      inputSchema: {
-        messageIds: z.array(z.string()).optional().describe('Specific message IDs to act on'),
-        query: z.string().optional().describe('Gmail search query (alternative to messageIds; acts on all matching)'),
-        max: z.number().optional().describe('Max messages when using --query (default: 100)'),
-        account: accountParam,
-      },
-    }, async ({ messageIds, query, max, account }) => {
+      inputSchema,
+    }, async (rawArgs) => {
+      const { messageIds, query, max, thread, account } = rawArgs as {
+        messageIds?: string[]; query?: string; max?: number; thread?: boolean; account?: string;
+      };
       const args = ['gmail', cmd];
       if (messageIds) args.push(...messageIds);
       if (query) args.push(`--query=${query}`);
       if (max !== undefined) args.push(`--max=${max}`);
+      if (supportsThread && thread) args.push('--thread');
       return runOrDiagnose(args, { account });
     });
   }

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

@@ -132,6 +132,23 @@ describe('bulk action tools (archive, mark_read, mark_unread, trash)', () => {
       });
     });
   }
+
+  // gog 0.25.0 — --thread is archive-only
+  it('gog_gmail_archive passes --thread to archive whole threads by id', async () => {
+    await handlers.get('gog_gmail_archive')!({ messageIds: ['t1', 't2'], thread: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['gmail', 'archive', 't1', 't2', '--thread'],
+      { account: undefined },
+    );
+  });
+
+  it('other bulk tools do not expose a thread param', async () => {
+    await handlers.get('gog_gmail_trash')!({ messageIds: ['m1'], thread: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['gmail', 'trash', 'm1'],
+      { account: undefined },
+    );
+  });
 });
 
 describe('gog_gmail_message_modify', () => {