gogcli-mcp 2.26.0 → 2.27.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.26.0"
+    "version": "2.27.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.26.0",
+      "version": "2.27.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

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

package/README.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **AI-developed project.** This codebase was built and is actively maintained by [Claude Code](https://www.anthropic.com/claude). Review all code and tool permissions before use.
 
-Base [Model Context Protocol](https://modelcontextprotocol.io) server that gives Claude access to Google Workspace via [gogcli](https://github.com/openclaw/gogcli). Includes 112 tools across 13 services: Sheets, Docs, Gmail, Calendar, Drive, Slides, Classroom, Chat, Apps Script, Tasks, Contacts, the generic Discovery API escape hatch, and Auth.
+Base [Model Context Protocol](https://modelcontextprotocol.io) server that gives Claude access to Google Workspace via [gogcli](https://github.com/openclaw/gogcli). Includes 114 tools across 13 services: Sheets, Docs, Gmail, Calendar, Drive, Slides, Classroom, Chat, Apps Script, Tasks, Contacts, the generic Discovery API escape hatch, and Auth.
 
 For extended Sheets or Docs support, see [gogcli-mcp-sheets](https://www.npmjs.com/package/gogcli-mcp-sheets) and [gogcli-mcp-docs](https://www.npmjs.com/package/gogcli-mcp-docs).
 
@@ -46,13 +46,13 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 claude mcp add gogcli-mcp -- gogcli-mcp
 ```
 
-## Tools (112)
+## Tools (114)
 
 | Service | Tools | Includes |
 |---------|-------|----------|
 | **Sheets** | 8 | get, update, append, clear, metadata, create, find-replace, run |
 | **Docs** | 7 | info, cat, create, write, find-replace, structure, run |
-| **Gmail** | 4 | search, get, send, run |
+| **Gmail** | 6 | search, get, send, reply, reply-all, run |
 | **Calendar** | 7 | events, get, create, update, delete, respond, run |
 | **Drive** | 11 | ls, search, get, mkdir, rename, move, delete, share, extract-text, read-bytes, run |
 | **Slides** | 7 | export, info, create, copy, list-slides, read-slide, run |

package/SKILL.md

@@ -32,13 +32,13 @@ MCP server wrapping [gogcli](https://github.com/openclaw/gogcli) — provides Cl
 
 `GOG_ACCOUNT` is optional — omit it to use gogcli's configured default account.
 
-## Tools (112)
+## Tools (114)
 
 | Service | Tools |
 |---------|-------|
 | **Sheets** (8) | get, update, append, clear, metadata, create, find-replace, run |
 | **Docs** (7) | info, cat, create, write, find-replace, structure, run |
-| **Gmail** (4) | search, get, send, run |
+| **Gmail** (6) | search, get, send, reply, reply-all, run |
 | **Calendar** (7) | events, get, create, update, delete, respond, run |
 | **Drive** (11) | ls, search, get, mkdir, rename, move, delete, share, extract-text, read-bytes, run |
 | **Slides** (7) | export, info, create, copy, list-slides, read-slide, run |

package/dist/index.js

@@ -31835,6 +31835,13 @@ function formatAuthHealth(raw, now) {
   }
   return accounts.map((a) => formatOneAccountHealth(a, now)).join("\n\n");
 }
+function assertNotBoth(inlineParam, fileParam, inlineValue, fileValue) {
+  if (inlineValue !== void 0 && fileValue !== void 0) {
+    throw new Error(
+      `${inlineParam} and ${fileParam} are mutually exclusive \u2014 gog accepts only one of them. Pass ${inlineParam} with the content itself (it is written to a temp file automatically when large), or ${fileParam} with a path that already exists on the gog server.`
+    );
+  }
+}
 
 // src/tools/api.ts
 function registerApiTools(server) {
@@ -33414,6 +33421,45 @@ function finish(base, itemsKey, merged, token) {
 }
 
 // src/tools/gmail.ts
+var replySchema = {
+  messageId: external_exports.string().describe("Gmail message ID to reply to \u2014 the short hex `id` from gog_gmail_get / _search (or gog_gmail_messages_search, gogcli-mcp-gmail only). NOT the threadId, NOT the RFC822 `<\u2026@host>` Message-Id header."),
+  body: external_exports.string().optional().describe("Reply body (plain text; required unless bodyHtml or bodyHtmlFile is set). Any size \u2014 a large body is written to a temp file on the gog server rather than inlined into the command line. Note gog strips trailing newlines from a file-delivered body."),
+  bodyHtml: external_exports.string().optional().describe("Reply body (HTML; optional). Pass the HTML itself at any size \u2014 a large body is written to a temp file on the gog server rather than inlined into the command line. Mutually exclusive with bodyHtmlFile."),
+  bodyHtmlFile: external_exports.string().optional().describe(`Path to an HTML file that ALREADY EXISTS on the gog server for the reply body. gog also accepts "-" for stdin, but this server never writes to gog's stdin, so "-" would hang until the call times out. Mutually exclusive with bodyHtml \u2014 supplying both is rejected. You rarely need this: bodyHtml handles large bodies on its own.`),
+  to: external_exports.array(external_exports.string()).optional().describe("Add or move recipients to To (repeatable). Added on top of the recipients inherited from the original message."),
+  cc: external_exports.array(external_exports.string()).optional().describe("Add or move recipients to Cc (repeatable)"),
+  bcc: external_exports.array(external_exports.string()).optional().describe("Add or move recipients to Bcc (repeatable)"),
+  remove: external_exports.array(external_exports.string()).optional().describe("Remove these recipients from all fields (repeatable) \u2014 e.g. to drop someone from a reply-all."),
+  subject: external_exports.string().optional().describe('Override reply subject (default: "Re: <original>"). A changed subject starts a NEW Gmail thread.'),
+  noQuote: external_exports.boolean().optional().describe("Do not include the original message quoted below the reply (default: the original is quoted)"),
+  attach: external_exports.array(external_exports.string()).optional().describe(`File paths to attach (repeatable), resolved ON THE GOG SERVER's filesystem \u2014 NOT this client's. Only usable when gog runs on the same machine you do (local stdio); on the hosted connector or any GOG_RUNNER_URL backend these paths do not exist and the call fails with "no such file or directory" \u2014 use attachInline there. Read on the server, base64-encoded with a MIME type inferred from the extension.`),
+  attachInline: attachInlineParam,
+  from: external_exports.string().optional().describe("Send from this email address (must be a verified send-as alias)"),
+  autoFromAddressedAlias: external_exports.boolean().optional().describe("When from is omitted, send from the verified send-as alias the original message was addressed TO, instead of the account's primary address \u2014 so a reply to mail sent to an alias goes back out from that alias. Ignored when from is set."),
+  signature: external_exports.boolean().optional().describe("Append the Gmail signature from the active send-as address"),
+  signatureFrom: external_exports.string().optional().describe("Append the Gmail signature from this send-as email address"),
+  signatureFile: external_exports.string().optional().describe("Append a local signature file (plain text or HTML), read on the gog server"),
+  account: accountParam
+};
+function appendReplyFlags(args, f) {
+  assertNotBoth("bodyHtml", "bodyHtmlFile", f.bodyHtml, f.bodyHtmlFile);
+  if (f.body) args.push(payloadArg("body", "body-file", f.body));
+  if (f.bodyHtml) args.push(payloadArg("body-html", "body-html-file", f.bodyHtml, "html"));
+  else if (f.bodyHtmlFile) args.push(`--body-html-file=${f.bodyHtmlFile}`);
+  if (f.to) for (const r of f.to) args.push(`--to=${r}`);
+  if (f.cc) for (const r of f.cc) args.push(`--cc=${r}`);
+  if (f.bcc) for (const r of f.bcc) args.push(`--bcc=${r}`);
+  if (f.remove) for (const r of f.remove) args.push(`--remove=${r}`);
+  if (f.subject) args.push(`--subject=${f.subject}`);
+  if (f.noQuote) args.push("--no-quote");
+  if (f.attach) for (const p of f.attach) args.push(`--attach=${p}`);
+  args.push(...inlineAttachmentArgs("attach", f.attachInline, args));
+  if (f.from) args.push(`--from=${f.from}`);
+  if (f.signature) args.push("--signature");
+  if (f.signatureFrom) args.push(`--signature-from=${f.signatureFrom}`);
+  if (f.signatureFile) args.push(`--signature-file=${f.signatureFile}`);
+  args.push(f.autoFromAddressedAlias ? "--auto-from-addressed-alias" : "--auto-from-addressed-alias=false");
+}
 function registerGmailTools(server) {
   server.registerTool("gog_gmail_search", {
     description: 'Search Gmail threads using Gmail query syntax (e.g. "from:alice subject:invoice is:unread"). The query is passed verbatim to Gmail; a bare name token (from:alison) matches per Gmail\'s own heuristics, a full address (from:alison@example.com) is exact. To match a contact across several addresses, OR them: from:(a@x.com OR b@y.com). Results are ALWAYS newest-first by Gmail\'s internalDate \u2014 the wrapper sorts them, so the first result is the most recent match and a recent message can never be buried below older ones. IMPORTANT \u2014 a response carrying "truncated": true is an INCOMPLETE view of the matches: NEVER report that a message does not exist, or that there is no such mail, on the strength of one. Page through it (pass nextPageToken back as `pageToken`), set maxPages to walk several pages in one call, or narrow the query, and only then draw a conclusion. If you already know the thread, do not search for it at all \u2014 read it directly with gog_gmail_thread_get, which returns the whole thread and cannot be truncated or mis-ranked.',
@@ -33466,7 +33512,7 @@ function registerGmailTools(server) {
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_gmail_send", {
-    description: 'Send an email. Two ways to attach a file: `attach` takes paths READ ON THE GOG SERVER, and `attachInline` takes the bytes themselves. Use attachInline unless you know the file exists on the same machine gog runs on \u2014 on the hosted connector and any remote deployment there is no shared filesystem, so no path you can name resolves there and `attach` will fail with "no such file or directory". When either is used, the JSON result echoes the attached filenames and byte sizes \u2014 check it to confirm the files were embedded.',
+    description: 'Send an email. Two ways to attach a file: `attach` takes paths READ ON THE GOG SERVER, and `attachInline` takes the bytes themselves. Use attachInline unless you know the file exists on the same machine gog runs on \u2014 on the hosted connector and any remote deployment there is no shared filesystem, so no path you can name resolves there and `attach` will fail with "no such file or directory". When either is used, the JSON result echoes the attached filenames and byte sizes \u2014 check it to confirm the files were embedded. NOT the tool for answering a message: replyToMessageId only files this in the right thread \u2014 the subject, recipients and body are entirely yours, and the original is not quoted unless you set quote. Use gog_gmail_reply / gog_gmail_reply_all instead, which inherit all three.',
     annotations: { destructiveHint: true },
     inputSchema: {
       to: external_exports.string().describe("Recipient(s), comma-separated"),
@@ -33474,23 +33520,43 @@ function registerGmailTools(server) {
       body: external_exports.string().describe("Email body (plain text). Any size \u2014 a large body is written to a temp file on the gog server rather than inlined into the command line. Note gog strips trailing newlines from a file-delivered body."),
       cc: external_exports.string().optional().describe("CC recipients, comma-separated"),
       bcc: external_exports.string().optional().describe("BCC recipients, comma-separated"),
-      replyToMessageId: external_exports.string().optional().describe("Message ID to reply to"),
-      threadId: external_exports.string().optional().describe("Thread ID to reply within"),
+      replyToMessageId: external_exports.string().optional().describe('Message ID to thread this message against \u2014 sets In-Reply-To/References only. It does NOT quote the original (pass quote for that), inherit its recipients, or prefix the subject with "Re:". For an actual reply use gog_gmail_reply.'),
+      threadId: external_exports.string().optional().describe("Thread ID to thread this message within. Same caveat as replyToMessageId: threading only, no quote and no inherited subject or recipients."),
+      quote: external_exports.boolean().optional().describe("Include the original message quoted below the body. Requires replyToMessageId or threadId. gog quotes by DEFAULT on gmail reply but never on gmail send, so without this a threaded send arrives with the original nowhere in it."),
       attach: external_exports.array(external_exports.string()).optional().describe(`File paths to attach (repeatable), resolved ON THE GOG SERVER's filesystem \u2014 NOT this client's. Only usable when gog runs on the same machine you do (local stdio); on the hosted connector or any GOG_RUNNER_URL backend these paths do not exist and the call fails with "no such file or directory" \u2014 use attachInline there. Each file is read on the server, base64-encoded with a MIME type inferred from its extension, and added as a multipart attachment.`),
       attachInline: attachInlineParam,
       account: accountParam
     }
-  }, async ({ to, subject, body, cc, bcc, replyToMessageId, threadId, attach, attachInline, account }) => {
+  }, async ({ to, subject, body, cc, bcc, replyToMessageId, threadId, quote, attach, attachInline, account }) => {
     const args = ["gmail", "send", `--to=${to}`, `--subject=${subject}`, payloadArg("body", "body-file", body)];
     if (cc) args.push(`--cc=${cc}`);
     if (bcc) args.push(`--bcc=${bcc}`);
     if (replyToMessageId) args.push(`--reply-to-message-id=${replyToMessageId}`);
     if (threadId) args.push(`--thread-id=${threadId}`);
+    if (quote) args.push("--quote");
     if (attach) for (const path of attach) args.push(`--attach=${path}`);
     const inline = inlineAttachmentArgs("attach", attachInline, args);
     args.push(...inline);
     return runOrDiagnose(args, { account });
   });
+  server.registerTool("gog_gmail_reply", {
+    description: 'Reply to a Gmail message (goes to the original sender only). USE THIS, not gog_gmail_send, whenever you are answering a message: it threads off the original AND inherits its "Re:" subject and quotes its body below yours, which gog_gmail_send does not \u2014 a send with replyToMessageId lands in the right thread but reads as a brand-new message, with the original nowhere in it. To answer every participant use gog_gmail_reply_all. The gogcli-mcp-gmail package adds two more routes with the same composition: gog_gmail_autoreply to reply across every message matching a query, and gog_gmail_drafts_reply to stage this exact reply as a draft instead of sending it.',
+    annotations: { destructiveHint: true },
+    inputSchema: replySchema
+  }, async ({ messageId, account, ...flags }) => {
+    const args = ["gmail", "reply", messageId];
+    appendReplyFlags(args, flags);
+    return runOrDiagnose(args, { account });
+  });
+  server.registerTool("gog_gmail_reply_all", {
+    description: 'Reply to all participants of a Gmail message (the sender plus every To/Cc recipient). Same inherited "Re:" subject and quoted original as gog_gmail_reply. Use the remove flag to drop specific recipients from the reply-all. To stage it as a draft rather than send it, use gog_gmail_drafts_reply_all (gogcli-mcp-gmail only).',
+    annotations: { destructiveHint: true },
+    inputSchema: replySchema
+  }, async ({ messageId, account, ...flags }) => {
+    const args = ["gmail", "reply-all", messageId];
+    appendReplyFlags(args, flags);
+    return runOrDiagnose(args, { account });
+  });
   registerRunTool(server, { service: "gmail", examples: '"archive", "mark-read", "labels"' });
 }
 
@@ -33818,7 +33884,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.26.0" : "0.0.0";
+var VERSION = true ? "2.27.0" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/dist/lib.js

@@ -23681,6 +23681,13 @@ function formatAuthHealth(raw, now) {
   }
   return accounts.map((a) => formatOneAccountHealth(a, now)).join("\n\n");
 }
+function assertNotBoth(inlineParam, fileParam, inlineValue, fileValue) {
+  if (inlineValue !== void 0 && fileValue !== void 0) {
+    throw new Error(
+      `${inlineParam} and ${fileParam} are mutually exclusive \u2014 gog accepts only one of them. Pass ${inlineParam} with the content itself (it is written to a temp file automatically when large), or ${fileParam} with a path that already exists on the gog server.`
+    );
+  }
+}
 
 // src/tools/api.ts
 function registerApiTools(server) {
@@ -25263,6 +25270,45 @@ function finish(base, itemsKey, merged, token) {
 }
 
 // src/tools/gmail.ts
+var replySchema = {
+  messageId: external_exports.string().describe("Gmail message ID to reply to \u2014 the short hex `id` from gog_gmail_get / _search (or gog_gmail_messages_search, gogcli-mcp-gmail only). NOT the threadId, NOT the RFC822 `<\u2026@host>` Message-Id header."),
+  body: external_exports.string().optional().describe("Reply body (plain text; required unless bodyHtml or bodyHtmlFile is set). Any size \u2014 a large body is written to a temp file on the gog server rather than inlined into the command line. Note gog strips trailing newlines from a file-delivered body."),
+  bodyHtml: external_exports.string().optional().describe("Reply body (HTML; optional). Pass the HTML itself at any size \u2014 a large body is written to a temp file on the gog server rather than inlined into the command line. Mutually exclusive with bodyHtmlFile."),
+  bodyHtmlFile: external_exports.string().optional().describe(`Path to an HTML file that ALREADY EXISTS on the gog server for the reply body. gog also accepts "-" for stdin, but this server never writes to gog's stdin, so "-" would hang until the call times out. Mutually exclusive with bodyHtml \u2014 supplying both is rejected. You rarely need this: bodyHtml handles large bodies on its own.`),
+  to: external_exports.array(external_exports.string()).optional().describe("Add or move recipients to To (repeatable). Added on top of the recipients inherited from the original message."),
+  cc: external_exports.array(external_exports.string()).optional().describe("Add or move recipients to Cc (repeatable)"),
+  bcc: external_exports.array(external_exports.string()).optional().describe("Add or move recipients to Bcc (repeatable)"),
+  remove: external_exports.array(external_exports.string()).optional().describe("Remove these recipients from all fields (repeatable) \u2014 e.g. to drop someone from a reply-all."),
+  subject: external_exports.string().optional().describe('Override reply subject (default: "Re: <original>"). A changed subject starts a NEW Gmail thread.'),
+  noQuote: external_exports.boolean().optional().describe("Do not include the original message quoted below the reply (default: the original is quoted)"),
+  attach: external_exports.array(external_exports.string()).optional().describe(`File paths to attach (repeatable), resolved ON THE GOG SERVER's filesystem \u2014 NOT this client's. Only usable when gog runs on the same machine you do (local stdio); on the hosted connector or any GOG_RUNNER_URL backend these paths do not exist and the call fails with "no such file or directory" \u2014 use attachInline there. Read on the server, base64-encoded with a MIME type inferred from the extension.`),
+  attachInline: attachInlineParam,
+  from: external_exports.string().optional().describe("Send from this email address (must be a verified send-as alias)"),
+  autoFromAddressedAlias: external_exports.boolean().optional().describe("When from is omitted, send from the verified send-as alias the original message was addressed TO, instead of the account's primary address \u2014 so a reply to mail sent to an alias goes back out from that alias. Ignored when from is set."),
+  signature: external_exports.boolean().optional().describe("Append the Gmail signature from the active send-as address"),
+  signatureFrom: external_exports.string().optional().describe("Append the Gmail signature from this send-as email address"),
+  signatureFile: external_exports.string().optional().describe("Append a local signature file (plain text or HTML), read on the gog server"),
+  account: accountParam
+};
+function appendReplyFlags(args, f) {
+  assertNotBoth("bodyHtml", "bodyHtmlFile", f.bodyHtml, f.bodyHtmlFile);
+  if (f.body) args.push(payloadArg("body", "body-file", f.body));
+  if (f.bodyHtml) args.push(payloadArg("body-html", "body-html-file", f.bodyHtml, "html"));
+  else if (f.bodyHtmlFile) args.push(`--body-html-file=${f.bodyHtmlFile}`);
+  if (f.to) for (const r of f.to) args.push(`--to=${r}`);
+  if (f.cc) for (const r of f.cc) args.push(`--cc=${r}`);
+  if (f.bcc) for (const r of f.bcc) args.push(`--bcc=${r}`);
+  if (f.remove) for (const r of f.remove) args.push(`--remove=${r}`);
+  if (f.subject) args.push(`--subject=${f.subject}`);
+  if (f.noQuote) args.push("--no-quote");
+  if (f.attach) for (const p of f.attach) args.push(`--attach=${p}`);
+  args.push(...inlineAttachmentArgs("attach", f.attachInline, args));
+  if (f.from) args.push(`--from=${f.from}`);
+  if (f.signature) args.push("--signature");
+  if (f.signatureFrom) args.push(`--signature-from=${f.signatureFrom}`);
+  if (f.signatureFile) args.push(`--signature-file=${f.signatureFile}`);
+  args.push(f.autoFromAddressedAlias ? "--auto-from-addressed-alias" : "--auto-from-addressed-alias=false");
+}
 function registerGmailTools(server) {
   server.registerTool("gog_gmail_search", {
     description: 'Search Gmail threads using Gmail query syntax (e.g. "from:alice subject:invoice is:unread"). The query is passed verbatim to Gmail; a bare name token (from:alison) matches per Gmail\'s own heuristics, a full address (from:alison@example.com) is exact. To match a contact across several addresses, OR them: from:(a@x.com OR b@y.com). Results are ALWAYS newest-first by Gmail\'s internalDate \u2014 the wrapper sorts them, so the first result is the most recent match and a recent message can never be buried below older ones. IMPORTANT \u2014 a response carrying "truncated": true is an INCOMPLETE view of the matches: NEVER report that a message does not exist, or that there is no such mail, on the strength of one. Page through it (pass nextPageToken back as `pageToken`), set maxPages to walk several pages in one call, or narrow the query, and only then draw a conclusion. If you already know the thread, do not search for it at all \u2014 read it directly with gog_gmail_thread_get, which returns the whole thread and cannot be truncated or mis-ranked.',
@@ -25315,7 +25361,7 @@ function registerGmailTools(server) {
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_gmail_send", {
-    description: 'Send an email. Two ways to attach a file: `attach` takes paths READ ON THE GOG SERVER, and `attachInline` takes the bytes themselves. Use attachInline unless you know the file exists on the same machine gog runs on \u2014 on the hosted connector and any remote deployment there is no shared filesystem, so no path you can name resolves there and `attach` will fail with "no such file or directory". When either is used, the JSON result echoes the attached filenames and byte sizes \u2014 check it to confirm the files were embedded.',
+    description: 'Send an email. Two ways to attach a file: `attach` takes paths READ ON THE GOG SERVER, and `attachInline` takes the bytes themselves. Use attachInline unless you know the file exists on the same machine gog runs on \u2014 on the hosted connector and any remote deployment there is no shared filesystem, so no path you can name resolves there and `attach` will fail with "no such file or directory". When either is used, the JSON result echoes the attached filenames and byte sizes \u2014 check it to confirm the files were embedded. NOT the tool for answering a message: replyToMessageId only files this in the right thread \u2014 the subject, recipients and body are entirely yours, and the original is not quoted unless you set quote. Use gog_gmail_reply / gog_gmail_reply_all instead, which inherit all three.',
     annotations: { destructiveHint: true },
     inputSchema: {
       to: external_exports.string().describe("Recipient(s), comma-separated"),
@@ -25323,23 +25369,43 @@ function registerGmailTools(server) {
       body: external_exports.string().describe("Email body (plain text). Any size \u2014 a large body is written to a temp file on the gog server rather than inlined into the command line. Note gog strips trailing newlines from a file-delivered body."),
       cc: external_exports.string().optional().describe("CC recipients, comma-separated"),
       bcc: external_exports.string().optional().describe("BCC recipients, comma-separated"),
-      replyToMessageId: external_exports.string().optional().describe("Message ID to reply to"),
-      threadId: external_exports.string().optional().describe("Thread ID to reply within"),
+      replyToMessageId: external_exports.string().optional().describe('Message ID to thread this message against \u2014 sets In-Reply-To/References only. It does NOT quote the original (pass quote for that), inherit its recipients, or prefix the subject with "Re:". For an actual reply use gog_gmail_reply.'),
+      threadId: external_exports.string().optional().describe("Thread ID to thread this message within. Same caveat as replyToMessageId: threading only, no quote and no inherited subject or recipients."),
+      quote: external_exports.boolean().optional().describe("Include the original message quoted below the body. Requires replyToMessageId or threadId. gog quotes by DEFAULT on gmail reply but never on gmail send, so without this a threaded send arrives with the original nowhere in it."),
       attach: external_exports.array(external_exports.string()).optional().describe(`File paths to attach (repeatable), resolved ON THE GOG SERVER's filesystem \u2014 NOT this client's. Only usable when gog runs on the same machine you do (local stdio); on the hosted connector or any GOG_RUNNER_URL backend these paths do not exist and the call fails with "no such file or directory" \u2014 use attachInline there. Each file is read on the server, base64-encoded with a MIME type inferred from its extension, and added as a multipart attachment.`),
       attachInline: attachInlineParam,
       account: accountParam
     }
-  }, async ({ to, subject, body, cc, bcc, replyToMessageId, threadId, attach, attachInline, account }) => {
+  }, async ({ to, subject, body, cc, bcc, replyToMessageId, threadId, quote, attach, attachInline, account }) => {
     const args = ["gmail", "send", `--to=${to}`, `--subject=${subject}`, payloadArg("body", "body-file", body)];
     if (cc) args.push(`--cc=${cc}`);
     if (bcc) args.push(`--bcc=${bcc}`);
     if (replyToMessageId) args.push(`--reply-to-message-id=${replyToMessageId}`);
     if (threadId) args.push(`--thread-id=${threadId}`);
+    if (quote) args.push("--quote");
     if (attach) for (const path of attach) args.push(`--attach=${path}`);
     const inline = inlineAttachmentArgs("attach", attachInline, args);
     args.push(...inline);
     return runOrDiagnose(args, { account });
   });
+  server.registerTool("gog_gmail_reply", {
+    description: 'Reply to a Gmail message (goes to the original sender only). USE THIS, not gog_gmail_send, whenever you are answering a message: it threads off the original AND inherits its "Re:" subject and quotes its body below yours, which gog_gmail_send does not \u2014 a send with replyToMessageId lands in the right thread but reads as a brand-new message, with the original nowhere in it. To answer every participant use gog_gmail_reply_all. The gogcli-mcp-gmail package adds two more routes with the same composition: gog_gmail_autoreply to reply across every message matching a query, and gog_gmail_drafts_reply to stage this exact reply as a draft instead of sending it.',
+    annotations: { destructiveHint: true },
+    inputSchema: replySchema
+  }, async ({ messageId, account, ...flags }) => {
+    const args = ["gmail", "reply", messageId];
+    appendReplyFlags(args, flags);
+    return runOrDiagnose(args, { account });
+  });
+  server.registerTool("gog_gmail_reply_all", {
+    description: 'Reply to all participants of a Gmail message (the sender plus every To/Cc recipient). Same inherited "Re:" subject and quoted original as gog_gmail_reply. Use the remove flag to drop specific recipients from the reply-all. To stage it as a draft rather than send it, use gog_gmail_drafts_reply_all (gogcli-mcp-gmail only).',
+    annotations: { destructiveHint: true },
+    inputSchema: replySchema
+  }, async ({ messageId, account, ...flags }) => {
+    const args = ["gmail", "reply-all", messageId];
+    appendReplyFlags(args, flags);
+    return runOrDiagnose(args, { account });
+  });
   registerRunTool(server, { service: "gmail", examples: '"archive", "mark-read", "labels"' });
 }
 
@@ -25667,7 +25733,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.26.0" : "0.0.0";
+var VERSION = true ? "2.27.0" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,
@@ -26178,6 +26244,8 @@ export {
   VERSION,
   accountParam,
   annotateTruncatedList,
+  appendReplyFlags,
+  assertNotBoth,
   attachInlineParam,
   authToolsFor,
   diagnose,
@@ -26209,6 +26277,7 @@ export {
   registerSheetsTools,
   registerSlidesTools,
   registerTasksTools,
+  replySchema,
   resolvePageToken,
   run,
   runBinary,

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "2.26.0",
+  "version": "2.27.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",
@@ -112,6 +112,14 @@
       "name": "gog_gmail_send",
       "description": "Send an email, with attachments from server-side paths (attach) or from base64 bytes sent with the call (attachInline, for remote deployments with no shared filesystem)"
     },
+    {
+      "name": "gog_gmail_reply",
+      "description": "Reply to a Gmail message (sender only), inheriting the \"Re:\" subject and quoting the original below your body"
+    },
+    {
+      "name": "gog_gmail_reply_all",
+      "description": "Reply to every participant of a Gmail message (sender plus all To/Cc), with the same inherited subject and quoted original"
+    },
     {
       "name": "gog_gmail_run",
       "description": "Run any gog gmail subcommand (escape hatch)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "2.26.0",
+  "version": "2.27.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.26.0",
+  "version": "2.27.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp",
-      "version": "2.26.0",
+      "version": "2.27.0",
       "transport": {
         "type": "stdio"
       },

package/src/lib.ts

@@ -16,6 +16,11 @@ export {
   registerSlidesTools,
   registerTasksTools,
 } from './server.js';
+// The reply/reply-all schema and flag builder live in the base package so the
+// gmail sub-package's draft-side twins reuse ONE definition — registering the
+// same tool name from both registrar lists would be a duplicate-name error.
+export { replySchema, appendReplyFlags } from './tools/gmail.js';
+export type { ReplyFlags } from './tools/gmail.js';
 export { run, runBinary, runExecutor, isGogFileArg, MIN_GOG_VERSION } from './runner.js';
 // Sub-package tools that read gog JSON through bare `run()` (rather than the
 // `runOrDiagnose` seam) must still apply this, or their timestamps skip the
@@ -57,4 +62,5 @@ export {
   pageAliasParam,
   resolvePageToken,
   registerRunTool,
+  assertNotBoth,
 } from './tools/utils.js';

package/src/tools/gmail.ts

@@ -1,9 +1,86 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { accountParam, runOrDiagnose, registerRunTool, payloadArg, pageTokenParam, pageAliasParam, resolvePageToken } from './utils.js';
+import { accountParam, runOrDiagnose, registerRunTool, payloadArg, pageTokenParam, pageAliasParam, resolvePageToken, assertNotBoth } from './utils.js';
 import { finalizeGmailSearch, fetchGmailPages } from '../gmail-results.js';
 import type { GogArg } from '../runner.js';
 import { attachInlineParam, inlineAttachmentArgs } from '../attachments.js';
+import type { InlineAttachmentInput } from '../attachments.js';
+
+// gmail reply / reply-all share an identical flag set (gog 0.27+); they differ
+// only in the subcommand and default recipient set (reply → sender; reply-all
+// → every participant). Recipient flags are repeatable on the CLI, so they are
+// arrays here. --to/--cc/--bcc ADD or MOVE recipients onto the inherited reply
+// set; --remove drops them. Body/HTML follow the same inline-or-file shape as
+// the draft tools.
+export const replySchema = {
+  messageId: z.string().describe('Gmail message ID to reply to — the short hex `id` from gog_gmail_get / _search (or gog_gmail_messages_search, gogcli-mcp-gmail only). NOT the threadId, NOT the RFC822 `<…@host>` Message-Id header.'),
+  body: z.string().optional().describe('Reply body (plain text; required unless bodyHtml or bodyHtmlFile is set). Any size — a large body is written to a temp file on the gog server rather than inlined into the command line. Note gog strips trailing newlines from a file-delivered body.'),
+  bodyHtml: z.string().optional().describe('Reply body (HTML; optional). Pass the HTML itself at any size — a large body is written to a temp file on the gog server rather than inlined into the command line. Mutually exclusive with bodyHtmlFile.'),
+  bodyHtmlFile: z.string().optional().describe('Path to an HTML file that ALREADY EXISTS on the gog server for the reply body. gog also accepts "-" for stdin, but this server never writes to gog\'s stdin, so "-" would hang until the call times out. Mutually exclusive with bodyHtml — supplying both is rejected. You rarely need this: bodyHtml handles large bodies on its own.'),
+  to: z.array(z.string()).optional().describe('Add or move recipients to To (repeatable). Added on top of the recipients inherited from the original message.'),
+  cc: z.array(z.string()).optional().describe('Add or move recipients to Cc (repeatable)'),
+  bcc: z.array(z.string()).optional().describe('Add or move recipients to Bcc (repeatable)'),
+  remove: z.array(z.string()).optional().describe('Remove these recipients from all fields (repeatable) — e.g. to drop someone from a reply-all.'),
+  subject: z.string().optional().describe('Override reply subject (default: "Re: <original>"). A changed subject starts a NEW Gmail thread.'),
+  noQuote: z.boolean().optional().describe('Do not include the original message quoted below the reply (default: the original is quoted)'),
+  attach: z.array(z.string()).optional().describe('File paths to attach (repeatable), resolved ON THE GOG SERVER\'s filesystem — NOT this client\'s. Only usable when gog runs on the same machine you do (local stdio); on the hosted connector or any GOG_RUNNER_URL backend these paths do not exist and the call fails with "no such file or directory" — use attachInline there. Read on the server, base64-encoded with a MIME type inferred from the extension.'),
+  attachInline: attachInlineParam,
+  from: z.string().optional().describe('Send from this email address (must be a verified send-as alias)'),
+  autoFromAddressedAlias: z.boolean().optional().describe('When from is omitted, send from the verified send-as alias the original message was addressed TO, instead of the account\'s primary address — so a reply to mail sent to an alias goes back out from that alias. Ignored when from is set.'),
+  signature: z.boolean().optional().describe('Append the Gmail signature from the active send-as address'),
+  signatureFrom: z.string().optional().describe('Append the Gmail signature from this send-as email address'),
+  signatureFile: z.string().optional().describe('Append a local signature file (plain text or HTML), read on the gog server'),
+  account: accountParam,
+};
+
+export type ReplyFlags = {
+  body?: string;
+  bodyHtml?: string;
+  bodyHtmlFile?: string;
+  to?: string[];
+  cc?: string[];
+  bcc?: string[];
+  remove?: string[];
+  subject?: string;
+  noQuote?: boolean;
+  attach?: string[];
+  attachInline?: InlineAttachmentInput[];
+  from?: string;
+  autoFromAddressedAlias?: boolean;
+  signature?: boolean;
+  signatureFrom?: string;
+  signatureFile?: string;
+};
+
+export function appendReplyFlags(args: GogArg[], f: ReplyFlags): void {
+  assertNotBoth('bodyHtml', 'bodyHtmlFile', f.bodyHtml, f.bodyHtmlFile);
+  if (f.body) args.push(payloadArg('body', 'body-file', f.body));
+  if (f.bodyHtml) args.push(payloadArg('body-html', 'body-html-file', f.bodyHtml, 'html'));
+  else if (f.bodyHtmlFile) args.push(`--body-html-file=${f.bodyHtmlFile}`);
+  if (f.to) for (const r of f.to) args.push(`--to=${r}`);
+  if (f.cc) for (const r of f.cc) args.push(`--cc=${r}`);
+  if (f.bcc) for (const r of f.bcc) args.push(`--bcc=${r}`);
+  if (f.remove) for (const r of f.remove) args.push(`--remove=${r}`);
+  if (f.subject) args.push(`--subject=${f.subject}`);
+  if (f.noQuote) args.push('--no-quote');
+  if (f.attach) for (const p of f.attach) args.push(`--attach=${p}`);
+  // Same repeatable --attach flag, but the bytes travel with the call: the
+  // executor writes each one to a temp file beside gog and passes that path.
+  // This is the only attachment route that works when the caller and gog do not
+  // share a filesystem (hosted connector, GOG_RUNNER_URL backend). `args` is
+  // passed so the size check sees the body too, which shares the same budget
+  // once payloadArg has turned it into a file arg.
+  args.push(...inlineAttachmentArgs('attach', f.attachInline, args));
+  if (f.from) args.push(`--from=${f.from}`);
+  if (f.signature) args.push('--signature');
+  if (f.signatureFrom) args.push(`--signature-from=${f.signatureFrom}`);
+  if (f.signatureFile) args.push(`--signature-file=${f.signatureFile}`);
+  // PINNED, not conditional: GOG_GMAIL_AUTO_FROM_ADDRESSED_ALIAS in the host env
+  // silently changes which address the mail goes out FROM, with nothing in the arg
+  // array to show for it — and the remote runner's backend env is not ours to set.
+  // An explicit flag is the only value authoritative on both transports.
+  args.push(f.autoFromAddressedAlias ? '--auto-from-addressed-alias' : '--auto-from-addressed-alias=false');
+}
 
 export function registerGmailTools(server: McpServer): void {
   server.registerTool('gog_gmail_search', {
@@ -73,7 +150,10 @@ export function registerGmailTools(server: McpServer): void {
       + 'the same machine gog runs on — on the hosted connector and any remote deployment there is no '
       + 'shared filesystem, so no path you can name resolves there and `attach` will fail with '
       + '"no such file or directory". When either is used, the JSON result echoes the attached filenames '
-      + 'and byte sizes — check it to confirm the files were embedded.',
+      + 'and byte sizes — check it to confirm the files were embedded. '
+      + 'NOT the tool for answering a message: replyToMessageId only files this in the right thread — the '
+      + 'subject, recipients and body are entirely yours, and the original is not quoted unless you set '
+      + 'quote. Use gog_gmail_reply / gog_gmail_reply_all instead, which inherit all three.',
     annotations: { destructiveHint: true },
     inputSchema: {
       to: z.string().describe('Recipient(s), comma-separated'),
@@ -81,13 +161,14 @@ export function registerGmailTools(server: McpServer): void {
       body: z.string().describe('Email body (plain text). Any size — a large body is written to a temp file on the gog server rather than inlined into the command line. Note gog strips trailing newlines from a file-delivered body.'),
       cc: z.string().optional().describe('CC recipients, comma-separated'),
       bcc: z.string().optional().describe('BCC recipients, comma-separated'),
-      replyToMessageId: z.string().optional().describe('Message ID to reply to'),
-      threadId: z.string().optional().describe('Thread ID to reply within'),
+      replyToMessageId: z.string().optional().describe('Message ID to thread this message against — sets In-Reply-To/References only. It does NOT quote the original (pass quote for that), inherit its recipients, or prefix the subject with "Re:". For an actual reply use gog_gmail_reply.'),
+      threadId: z.string().optional().describe('Thread ID to thread this message within. Same caveat as replyToMessageId: threading only, no quote and no inherited subject or recipients.'),
+      quote: z.boolean().optional().describe('Include the original message quoted below the body. Requires replyToMessageId or threadId. gog quotes by DEFAULT on gmail reply but never on gmail send, so without this a threaded send arrives with the original nowhere in it.'),
       attach: z.array(z.string()).optional().describe('File paths to attach (repeatable), resolved ON THE GOG SERVER\'s filesystem — NOT this client\'s. Only usable when gog runs on the same machine you do (local stdio); on the hosted connector or any GOG_RUNNER_URL backend these paths do not exist and the call fails with "no such file or directory" — use attachInline there. Each file is read on the server, base64-encoded with a MIME type inferred from its extension, and added as a multipart attachment.'),
       attachInline: attachInlineParam,
       account: accountParam,
     },
-  }, async ({ to, subject, body, cc, bcc, replyToMessageId, threadId, attach, attachInline, account }) => {
+  }, async ({ to, subject, body, cc, bcc, replyToMessageId, threadId, quote, attach, attachInline, account }) => {
     // A long body cannot ride in argv: the hosted runner caps a single arg and
     // Linux caps MAX_ARG_STRLEN at 128 KiB. payloadArg swaps it for --body-file
     // past the shared threshold; the executor materializes the temp file.
@@ -96,6 +177,10 @@ export function registerGmailTools(server: McpServer): void {
     if (bcc) args.push(`--bcc=${bcc}`);
     if (replyToMessageId) args.push(`--reply-to-message-id=${replyToMessageId}`);
     if (threadId) args.push(`--thread-id=${threadId}`);
+    // gog's --quote on `gmail send` is opt-in (a plain bool defaulting false),
+    // the mirror image of `gmail reply`, where quoting is the default and
+    // --no-quote opts out. Nothing here can be inferred from the reply target.
+    if (quote) args.push('--quote');
     if (attach) for (const path of attach) args.push(`--attach=${path}`);
     // Same repeatable --attach flag; the executor materializes each payload to a
     // temp file beside gog and substitutes its path. `args` is passed so the
@@ -106,5 +191,51 @@ export function registerGmailTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  // ==========================================================================
+  // REPLY / REPLY-ALL
+  //
+  // These live here, in the base package, because gog_gmail_send +
+  // replyToMessageId is NOT a reply. It sets In-Reply-To/References — so Gmail
+  // files it in the right thread — and stops there: no quoted original, no
+  // inherited "Re:" subject, no inherited recipients. To anyone reading the
+  // body it arrives as a brand-new message.
+  //
+  // The asymmetry is gog's: `gmail reply` quotes BY DEFAULT (opt out with
+  // --no-quote), while `gmail send` quotes only on an explicit --quote
+  // (internal/cmd/gmail_send.go, a plain bool defaulting false). The gmail
+  // sub-package reuses replySchema/appendReplyFlags for its draft-side twins
+  // rather than declaring a second copy — registering these tools twice in the
+  // one server would be a duplicate-name error.
+  // ==========================================================================
+  server.registerTool('gog_gmail_reply', {
+    description:
+      'Reply to a Gmail message (goes to the original sender only). USE THIS, not gog_gmail_send, whenever you are '
+      + 'answering a message: it threads off the original AND inherits its "Re:" subject and quotes its body below '
+      + 'yours, which gog_gmail_send does not — a send with replyToMessageId lands in the right thread but reads as a '
+      + 'brand-new message, with the original nowhere in it. To answer every participant use gog_gmail_reply_all. '
+      + 'The gogcli-mcp-gmail package adds two more routes with the same composition: gog_gmail_autoreply to reply '
+      + 'across every message matching a query, and gog_gmail_drafts_reply to stage this exact reply as a draft '
+      + 'instead of sending it.',
+    annotations: { destructiveHint: true },
+    inputSchema: replySchema,
+  }, async ({ messageId, account, ...flags }) => {
+    const args: GogArg[] = ['gmail', 'reply', messageId];
+    appendReplyFlags(args, flags);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_gmail_reply_all', {
+    description:
+      'Reply to all participants of a Gmail message (the sender plus every To/Cc recipient). Same inherited "Re:" '
+      + 'subject and quoted original as gog_gmail_reply. Use the remove flag to drop specific recipients from the '
+      + 'reply-all. To stage it as a draft rather than send it, use gog_gmail_drafts_reply_all (gogcli-mcp-gmail only).',
+    annotations: { destructiveHint: true },
+    inputSchema: replySchema,
+  }, async ({ messageId, account, ...flags }) => {
+    const args: GogArg[] = ['gmail', 'reply-all', messageId];
+    appendReplyFlags(args, flags);
+    return runOrDiagnose(args, { account });
+  });
+
   registerRunTool(server, { service: 'gmail', examples: '"archive", "mark-read", "labels"' });
 }

package/src/tools/utils.ts

@@ -441,3 +441,23 @@ export function formatAuthHealth(raw: string, now: number): string {
   }
   return accounts.map((a) => formatOneAccountHealth(a, now)).join('\n\n');
 }
+
+// gog rejects an inline flag together with its --*-file twin — `gmail drafts
+// create` errors with "use only one of --body-html or --body-html-file", and
+// `gmail forward` does the same for --note (misreporting it as --body). Catch
+// the conflict here so the caller gets a message naming the TOOL params it
+// actually passed, instead of a gog error naming flags it never saw.
+export function assertNotBoth(
+  inlineParam: string,
+  fileParam: string,
+  inlineValue: string | undefined,
+  fileValue: string | undefined,
+): void {
+  if (inlineValue !== undefined && fileValue !== undefined) {
+    throw new Error(
+      `${inlineParam} and ${fileParam} are mutually exclusive — gog accepts only one of them. ` +
+      `Pass ${inlineParam} with the content itself (it is written to a temp file automatically when large), ` +
+      `or ${fileParam} with a path that already exists on the gog server.`,
+    );
+  }
+}

package/src/worker.ts

@@ -38,7 +38,7 @@ import { gogAuth, CONNECTOR_INSTRUCTIONS, type GogProps } from './connector-auth
 // connector with all ~360 tools at once. Add whichever paths you want as separate
 // connectors in claude.ai (each authorizes with the same connector key).
 
-const VERSION = '2.26.0'; // x-release-please-version
+const VERSION = '2.27.0'; // x-release-please-version
 
 // Build an McpAgent subclass whose init() registers `registrars` onto its server,
 // each handler wrapped in the ALS scope carrying the per-session Fly executor.

package/tests/server.test.ts

@@ -43,3 +43,62 @@ describe('VERSION', () => {
     expect(VERSION).toBe('0.0.0');
   });
 });
+
+// The tool counts in README.md, SKILL.md and manifest.json are hand-maintained
+// and have now drifted twice (0ec3470 "correct the stale tool counts", then
+// again when reply/reply-all landed). They are the first thing a reader sees,
+// so derive the truth from the registrars and fail the build on a mismatch
+// rather than catching it in review a release later.
+describe('published tool counts match the registrars', () => {
+  const readPkgFile = async (name: string) => {
+    const { readFile } = await import('node:fs/promises');
+    const { fileURLToPath } = await import('node:url');
+    return readFile(fileURLToPath(new URL(`../${name}`, import.meta.url)), 'utf8');
+  };
+
+  const liveToolNames = async (): Promise<string[]> => {
+    const harness = await createTestHarness((server) => {
+      for (const register of BASE_TOOL_REGISTRARS) register(server, undefined);
+    });
+    const names = (await harness.listTools()).map((t) => t.name);
+    await harness.close();
+    return names;
+  };
+
+  it('manifest.json lists exactly the registered tools', async () => {
+    const names = await liveToolNames();
+    const manifest = JSON.parse(await readPkgFile('manifest.json')) as { tools: Array<{ name: string }> };
+    expect([...manifest.tools.map((t) => t.name)].sort()).toEqual([...names].sort());
+  });
+
+  it.each(['README.md', 'SKILL.md'])('%s states the real total', async (file) => {
+    const total = (await liveToolNames()).length;
+    const text = await readPkgFile(file);
+    const heading = /^## Tools \((\d+)\)$/m.exec(text);
+    expect(heading, `${file} has no "## Tools (N)" heading`).not.toBeNull();
+    expect(Number(heading![1])).toBe(total);
+    // README also states the count in its opening paragraph.
+    const prose = /Includes (\d+) tools across/.exec(text);
+    if (prose) expect(Number(prose[1])).toBe(total);
+  });
+
+  it.each(['README.md', 'SKILL.md'])('%s states the real per-service counts', async (file) => {
+    const names = await liveToolNames();
+    const text = await readPkgFile(file);
+    // README: `| **Gmail** | 6 | …`   SKILL: `| **Gmail** (6) | …`
+    const rows = [...text.matchAll(/^\| \*\*(.+?)\*\*(?: \((\d+)\)| \| (\d+))? \|/gm)];
+    expect(rows.length).toBeGreaterThan(0);
+    const service = (row: string) => row.toLowerCase().replace(/[^a-z]/g, '');
+    // Map a table label onto the gog_<service>_ prefix its tools carry.
+    const prefixFor: Record<string, string> = {
+      appsscript: 'appscript', discoveryapi: 'api',
+    };
+    for (const row of rows) {
+      const stated = Number(row[2] ?? row[3]);
+      if (!Number.isFinite(stated)) continue;
+      const key = service(row[1]);
+      const prefix = `gog_${prefixFor[key] ?? key}_`;
+      expect(names.filter((n) => n.startsWith(prefix)).length, `${file} row ${row[1]}`).toBe(stated);
+    }
+  });
+});

package/tests/tools/gmail.test.ts

@@ -260,6 +260,25 @@ describe('gog_gmail_send', () => {
     );
   });
 
+  // gog's --quote is opt-in on `gmail send` and default-on for `gmail reply`;
+  // a threaded send without it arrives with the original nowhere in the body.
+  it('appends --quote only when quote is set', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_gmail_send', {
+      to: 'bob@example.com', subject: 'Re: Hi', body: 'Sure',
+      replyToMessageId: 'msg1', quote: true,
+    });
+    expect(runner.run).toHaveBeenCalledWith(
+      [
+        'gmail', 'send',
+        '--to=bob@example.com', '--subject=Re: Hi', '--body=Sure',
+        '--reply-to-message-id=msg1', '--quote',
+      ],
+      { account: undefined },
+    );
+  });
+
   it('appends one --attach flag per file path', async () => {
     vi.mocked(runner.run).mockResolvedValue('{}');
     const harness = await setupHandlers();
@@ -423,3 +442,304 @@ describe('gog_gmail_run', () => {
     expect(result.content[0].text).toBe('Error: Run failed');
   });
 });
+
+// ============================================================================
+// REPLY / REPLY-ALL. The base package used to expose gog_gmail_send as its only
+// Gmail write, so replying meant send + replyToMessageId: that threads the
+// message (In-Reply-To/References) but quotes nothing, inherits no recipients
+// and no "Re:" subject — the reply lands looking like a brand-new message.
+// gog's `gmail reply` quotes BY DEFAULT (opt out with --no-quote), which is why
+// these are separate tools rather than flags on send.
+// ============================================================================
+describe.each([
+  ['gog_gmail_reply', 'reply'],
+  ['gog_gmail_reply_all', 'reply-all'],
+])('%s', (tool, subcommand) => {
+  it('calls run with the message id and body, quoting by default', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{"id":"msg9"}');
+    const harness = await setupHandlers();
+    await harness.callTool(tool, { messageId: 'msg1', body: 'Sounds good' });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['gmail', subcommand, 'msg1', '--body=Sounds good', '--auto-from-addressed-alias=false'],
+      { account: undefined },
+    );
+  });
+
+  it('appends --no-quote only when noQuote is set', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool(tool, { messageId: 'msg1', body: 'Ack', noQuote: true });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['gmail', subcommand, 'msg1', '--body=Ack', '--no-quote', '--auto-from-addressed-alias=false'],
+      { account: undefined },
+    );
+  });
+
+  it('appends optional flags when provided', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool(tool, {
+      messageId: 'msg1',
+      body: 'Adding Carol',
+      to: ['bob@example.com'],
+      cc: ['carol@example.com'],
+      bcc: ['dave@example.com'],
+      remove: ['eve@example.com'],
+      subject: 'Re: Custom',
+      from: 'me@example.com',
+      account: 'me@example.com',
+    });
+    expect(runner.run).toHaveBeenCalledWith(
+      [
+        'gmail', subcommand, 'msg1', '--body=Adding Carol',
+        '--to=bob@example.com', '--cc=carol@example.com', '--bcc=dave@example.com',
+        '--remove=eve@example.com', '--subject=Re: Custom', '--from=me@example.com',
+        '--auto-from-addressed-alias=false',
+      ],
+      { account: 'me@example.com' },
+    );
+  });
+
+  it('pins --auto-from-addressed-alias on when requested', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool(tool, { messageId: 'msg1', body: 'Hi', autoFromAddressedAlias: true });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['gmail', subcommand, 'msg1', '--body=Hi', '--auto-from-addressed-alias'],
+      { account: undefined },
+    );
+  });
+
+  it('appends one --attach flag per file path', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool(tool, {
+      messageId: 'msg1',
+      body: 'See attached',
+      attach: ['/tmp/shot.png', '/tmp/notes.pdf'],
+    });
+    expect(runner.run).toHaveBeenCalledWith(
+      [
+        'gmail', subcommand, 'msg1', '--body=See attached',
+        '--attach=/tmp/shot.png', '--attach=/tmp/notes.pdf',
+        '--auto-from-addressed-alias=false',
+      ],
+      { account: undefined },
+    );
+  });
+
+  it('turns attachInline bytes into a --attach file arg', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    const bytes = Buffer.from('hi').toString('base64');
+    await harness.callTool(tool, {
+      messageId: 'msg1',
+      body: 'Bytes',
+      attachInline: [{ filename: 'a.txt', contentBase64: bytes }],
+    });
+    expect(runner.run).toHaveBeenCalledWith(
+      [
+        'gmail', subcommand, 'msg1', '--body=Bytes',
+        { kind: 'file', flag: 'attach', contents: bytes, encoding: 'base64', filename: 'a.txt' },
+        '--auto-from-addressed-alias=false',
+      ],
+      { account: undefined },
+    );
+  });
+
+  it('routes an oversize body to --body-file', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    const big = 'x'.repeat(PAYLOAD_INLINE_MAX + 1);
+    await harness.callTool(tool, { messageId: 'msg1', body: big });
+    expect(runner.run).toHaveBeenCalledWith(
+      [
+        'gmail', subcommand, 'msg1',
+        { kind: 'file', flag: 'body-file', contents: big, ext: undefined },
+        '--auto-from-addressed-alias=false',
+      ],
+      { account: undefined },
+    );
+  });
+
+  it('returns error text on failure', async () => {
+    vi.mocked(runner.run).mockRejectedValue(new Error('Reply failed'));
+    const harness = await setupHandlers();
+    const result = await harness.callTool(tool, { messageId: 'msg1', body: 'x' });
+    expect(result.content[0].text).toBe('Error: Reply failed');
+  });
+});
+
+// Moved here with the tools themselves: reply/reply-all used to live in the
+// gmail sub-package, which now imports replySchema/appendReplyFlags from this
+// package instead of declaring a second copy.
+describe('gog_gmail_reply — full flag set', () => {
+  it('calls runOrDiagnose with messageId and --body', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_gmail_reply', { messageId: 'm1', body: 'Thanks' });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['gmail', 'reply', 'm1', '--body=Thanks', '--auto-from-addressed-alias=false'],
+      { account: undefined },
+    );
+  });
+
+  it('passes all reply flags including repeatable recipients', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_gmail_reply', {
+      messageId: 'm1',
+      body: 'Hi',
+      bodyHtml: '<p>Hi</p>',
+      to: ['a@b.com', 'c@d.com'],
+      cc: ['cc@x.com'],
+      bcc: ['bcc@x.com'],
+      remove: ['old@x.com'],
+      subject: 'New subject',
+      noQuote: true,
+      attach: ['/tmp/a.pdf', '/tmp/b.pdf'],
+      from: 'me@x.com',
+      signature: true,
+      signatureFrom: 'alias@x.com',
+      signatureFile: '/tmp/sig.txt',
+      account: 'me@gmail.com',
+    });
+    expect(runner.run).toHaveBeenCalledWith(
+      [
+        'gmail', 'reply', 'm1',
+        '--body=Hi',
+        '--body-html=<p>Hi</p>',
+        '--to=a@b.com',
+        '--to=c@d.com',
+        '--cc=cc@x.com',
+        '--bcc=bcc@x.com',
+        '--remove=old@x.com',
+        '--subject=New subject',
+        '--no-quote',
+        '--attach=/tmp/a.pdf',
+        '--attach=/tmp/b.pdf',
+        '--from=me@x.com',
+        '--signature',
+        '--signature-from=alias@x.com',
+        '--signature-file=/tmp/sig.txt', '--auto-from-addressed-alias=false'
+      ],
+      { account: 'me@gmail.com' },
+    );
+  });
+
+  it('omits --no-quote and --signature when false', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_gmail_reply', { messageId: 'm1', body: 'Hi', noQuote: false, signature: false });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['gmail', 'reply', 'm1', '--body=Hi', '--auto-from-addressed-alias=false'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_gmail_reply_all — full flag set', () => {
+  it('uses the reply-all subcommand', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_gmail_reply_all', { messageId: 'm1', body: 'Thanks all' });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['gmail', 'reply-all', 'm1', '--body=Thanks all', '--auto-from-addressed-alias=false'],
+      { account: undefined },
+    );
+  });
+
+  it('passes repeatable recipient and signature flags', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_gmail_reply_all', {
+      messageId: 'm1',
+      bodyHtml: '<p>Hi</p>',
+      cc: ['x@y.com', 'z@y.com'],
+      remove: ['drop@y.com'],
+      signatureFile: '/tmp/sig.html',
+    });
+    expect(runner.run).toHaveBeenCalledWith(
+      [
+        'gmail', 'reply-all', 'm1',
+        '--body-html=<p>Hi</p>',
+        '--cc=x@y.com',
+        '--cc=z@y.com',
+        '--remove=drop@y.com',
+        '--signature-file=/tmp/sig.html', '--auto-from-addressed-alias=false'
+      ],
+      { account: undefined },
+    );
+  });
+});
+describe('gog_gmail_reply body-vs-file conflicts', () => {
+  it('rejects bodyHtml plus bodyHtmlFile before gog runs', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    const res = await harness.callTool('gog_gmail_reply', {
+      messageId: 'm1', bodyHtml: '<p>Hi</p>', bodyHtmlFile: '/tmp/b.html',
+    });
+    expect(res.isError).toBe(true);
+    expect(res.content[0].text).toContain('bodyHtml and bodyHtmlFile are mutually exclusive');
+    expect(runner.run).not.toHaveBeenCalled();
+  });
+
+  it('treats an empty-string bodyHtml as supplied, so it still conflicts', async () => {
+    // Guards the `!== undefined` check against a falsy-but-present value
+    // sliding through to gog, which rejects the pair regardless of content.
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    const res = await harness.callTool('gog_gmail_reply', {
+      messageId: 'm1', body: 'B', bodyHtml: '', bodyHtmlFile: '/tmp/b.html',
+    });
+    expect(res.isError).toBe(true);
+    expect(runner.run).not.toHaveBeenCalled();
+  });
+
+  it('passes bodyHtmlFile alone through as --body-html-file', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_gmail_reply', { messageId: 'm1', body: 'Hi', bodyHtmlFile: '/tmp/b.html' });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['gmail', 'reply', 'm1', '--body=Hi', '--body-html-file=/tmp/b.html', '--auto-from-addressed-alias=false'],
+      { account: undefined },
+    );
+  });
+
+  it('routes a large body and bodyHtml to file args', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{}');
+    const harness = await setupHandlers();
+    const big = 'x'.repeat(PAYLOAD_INLINE_MAX + 1);
+    const bigHtml = `<p>${'y'.repeat(PAYLOAD_INLINE_MAX)}</p>`;
+    await harness.callTool('gog_gmail_reply', { messageId: 'm1', body: big, bodyHtml: bigHtml });
+    expect(runner.run).toHaveBeenCalledWith(
+      [
+        'gmail', 'reply', 'm1',
+        { kind: 'file', flag: 'body-file', contents: big, ext: undefined },
+        { kind: 'file', flag: 'body-html-file', contents: bigHtml, ext: 'html' },
+        '--auto-from-addressed-alias=false',
+      ],
+      { account: undefined },
+    );
+  });
+});
+
+// gog reads "-" from stdin, but runner.ts spawns with default stdio and never
+// writes to or closes the child's stdin, so a "-" here hangs until the 30s
+// timeout. No file param may advertise it as usable.
+describe('reply file params never advertise stdin as usable', () => {
+  it.each(['gog_gmail_reply', 'gog_gmail_reply_all'])('%s.bodyHtmlFile warns that stdin hangs', async (tool) => {
+    const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+    const server = new McpServer({ name: 'test', version: '0.0.0' });
+    const configs = new Map<string, Record<string, { description?: string }>>();
+    vi.spyOn(server, 'registerTool').mockImplementation((name, config) => {
+      configs.set(name, (config as { inputSchema: Record<string, { description?: string }> }).inputSchema);
+      return undefined as never;
+    });
+    registerGmailTools(server);
+    const desc = configs.get(tool)?.bodyHtmlFile?.description ?? '';
+    expect(desc).not.toBe('');
+    expect(desc).not.toMatch(/(?:or|use)\s+"?-"?\s+(?:for|to read)/i);
+    expect(desc).toMatch(/stdin/i);
+  });
+});