gogcli-mcp-gmail 2.7.0 → 2.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Hall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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.0" : "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.0",
+  "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.0",
+  "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', () => {