gogcli-mcp-gmail 2.0.12 → 2.3.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## [2.1.0](https://github.com/chrischall/gogcli-mcp/compare/v2.0.13...v2.1.0) (2026-05-25)
+
+
+### Features
+
+* **gmail:** add gogcli-mcp-gmail sub-package ([fac0f51](https://github.com/chrischall/gogcli-mcp/commit/fac0f515fd2ea587c570d7ac70c080cb8dc486ac))
+
+
+### Refactor
+
+* aggressive cleanup pass (audit findings) ([e635b39](https://github.com/chrischall/gogcli-mcp/commit/e635b391cf611e9c102a422ffbce5ebe28687b80))
+* review-pass cleanup (enums, shared schemas, test harness) ([ea851de](https://github.com/chrischall/gogcli-mcp/commit/ea851deb30b9cfef3f07ed506a011fc363b34018))
+
+
+### Documentation
+
+* update gogcli repo URLs to openclaw/gogcli (was steipete/gogcli) ([951a181](https://github.com/chrischall/gogcli-mcp/commit/951a1818ebc269f203aee723ccbea32c13817d8b))

package/dist/index.js

@@ -31074,7 +31074,7 @@ async function run(args, options = {}) {
 
 // ../gogcli-mcp/src/tools/utils.ts
 var accountParam = external_exports.string().optional().describe(
-  "Google account email to use (overrides GOG_ACCOUNT env var)"
+  "Google account email to use, e.g. you@gmail.com \u2014 must be the full address, not a bare username. Overrides the GOG_ACCOUNT env var. Omit to use the single configured account."
 );
 var ids = {
   course: external_exports.string().describe("Course ID"),
@@ -31133,26 +31133,41 @@ function toError(err) {
 }
 var AUTH_ERROR_PATTERN = /\b(401|unauthorized|token.*(expired|revoked)|invalid_grant)\b/i;
 var TRANSIENT_ERROR_PATTERN = /\b429\b|\b5\d\d\b|\bquota\b|rateLimit|\bDEADLINE_EXCEEDED\b/i;
+var GRID_LIMIT_ERROR_PATTERN = /exceeds grid limits/i;
 var AUTH_HINT = "\n\nAuthentication may have expired. Use gog_auth_add to re-authorize the account. Ask the user if they would like to re-authenticate.";
 var TRANSIENT_HINT = "\n\nThis error is often transient. Retry the same call before trying a different approach (do not fall back to smaller writes or row-by-row operations).";
+var GRID_LIMIT_HINT = "\n\nThe target range is outside the sheet's current grid. Add the missing rows or columns first with gog_sheets_insert (dimension: rows or cols), then retry the write.";
+function formatAccountList(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed?.accounts)) {
+      return parsed.accounts.map((a) => a?.email).filter(Boolean).join("\n");
+    }
+  } catch {
+  }
+  return raw.trim();
+}
+async function diagnose(err) {
+  const errText = toError(err).content[0].text;
+  const isAuthError = AUTH_ERROR_PATTERN.test(errText);
+  const isTransientError = !isAuthError && TRANSIENT_ERROR_PATTERN.test(errText);
+  const isGridLimitError = GRID_LIMIT_ERROR_PATTERN.test(errText);
+  const hint = isAuthError ? AUTH_HINT : isTransientError ? TRANSIENT_HINT : isGridLimitError ? GRID_LIMIT_HINT : "";
+  try {
+    const accounts = formatAccountList(await run(["auth", "list"]));
+    return toText(`${errText}
+
+Configured accounts:
+${accounts || "(none)"}${hint}`);
+  } catch {
+    return toText(`${errText}${hint}`);
+  }
+}
 async function runOrDiagnose(args, options) {
   try {
     return toText(await run(args, options));
   } catch (err) {
-    const base = toError(err);
-    const errText = base.content[0].text;
-    const isAuthError = AUTH_ERROR_PATTERN.test(errText);
-    const isTransientError = !isAuthError && TRANSIENT_ERROR_PATTERN.test(errText);
-    const hint = isAuthError ? AUTH_HINT : isTransientError ? TRANSIENT_HINT : "";
-    try {
-      const accounts = await run(["auth", "list"]);
-      return toText(`${errText}
-
-Configured accounts:
-${accounts}${hint}`);
-    } catch {
-      return toText(`${errText}${hint}`);
-    }
+    return diagnose(err);
   }
 }
 
@@ -31221,7 +31236,7 @@ function registerAuthTools(server2) {
 // ../gogcli-mcp/src/tools/gmail.ts
 function registerGmailTools(server2) {
   server2.registerTool("gog_gmail_search", {
-    description: 'Search Gmail threads using Gmail query syntax (e.g. "from:alice subject:invoice is:unread").',
+    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).`,
     annotations: { readOnlyHint: true },
     inputSchema: {
       query: external_exports.string().describe("Gmail search query"),
@@ -31272,9 +31287,15 @@ function registerGmailTools(server2) {
 
 // ../gogcli-mcp/src/tools/sheets.ts
 var cellValueParam = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean(), external_exports.null()]);
+var dryRunParam = external_exports.boolean().optional().describe(
+  "Preview the operation without modifying the sheet (gog --dry-run): reports the intended actions and exits without writing."
+);
+var failIfNotEmptyParam = external_exports.boolean().optional().describe(
+  'Safety guard against silent overwrites: before writing, read the target range and refuse the write if any target cell already holds data. Costs one extra read. Anchor ranges (e.g. "Sheet1!A1") are expanded to the full area your values will cover; explicit and named ranges are checked as-is.'
+);
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.0.12" : "0.0.0";
+var VERSION = true ? "2.3.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31283,6 +31304,37 @@ function createServer(options) {
 }
 
 // src/tools/gmail-extra.ts
+var SNIPPET_HEADERS = ["From", "To", "Cc", "Subject", "Date"];
+function summarizeMessage(m) {
+  const rawHeaders = m.payload?.headers;
+  const headers = {};
+  if (Array.isArray(rawHeaders)) {
+    for (const h of rawHeaders) {
+      if (h.name && SNIPPET_HEADERS.includes(h.name)) headers[h.name] = h.value;
+    }
+  }
+  return {
+    id: m.id,
+    threadId: m.threadId,
+    internalDate: m.internalDate,
+    labelIds: m.labelIds,
+    snippet: m.snippet,
+    headers
+  };
+}
+function trimThread(result, latestN, snippetsOnly) {
+  try {
+    const parsed = JSON.parse(result.content[0].text);
+    const messages = parsed.thread?.messages;
+    if (!Array.isArray(messages)) return result;
+    let trimmed = messages;
+    if (latestN !== void 0) trimmed = trimmed.slice(-latestN);
+    if (snippetsOnly) trimmed = trimmed.map((m) => summarizeMessage(m));
+    return toText(JSON.stringify({ ...parsed, thread: { ...parsed.thread, messages: trimmed } }));
+  } catch {
+    return result;
+  }
+}
 function registerExtraGmailTools(server2) {
   server2.registerTool("gog_gmail_raw", {
     description: "Dump the raw Gmail API response as JSON (lossless; for scripting and LLM consumption).",
@@ -31424,23 +31476,27 @@ function registerExtraGmailTools(server2) {
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_gmail_thread_get", {
-    description: "Get a Gmail thread with all messages, optionally downloading attachments and sanitizing content for agent consumption.",
+    description: "Get a Gmail thread with all messages. For long threads that overflow context, use latestN to fetch only the most recent messages and/or snippetsOnly for a lightweight per-message headers+snippet view; sanitizeContent strips raw payloads/HTML and is the biggest size reducer when you do need bodies.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       threadId: external_exports.string().describe("Gmail thread ID"),
       download: external_exports.boolean().optional().describe("Download all attachments"),
       full: external_exports.boolean().optional().describe("Show full message bodies"),
-      sanitizeContent: external_exports.boolean().optional().describe("Strip HTML, remove URLs, omit raw payloads from JSON"),
+      sanitizeContent: external_exports.boolean().optional().describe("Strip HTML, remove URLs, omit raw payloads from JSON (largest payload-size reduction)"),
+      latestN: external_exports.number().int().positive().optional().describe("Return only the most recent N messages in the thread (wrapper-side trim; avoids overflowing context on long threads)"),
+      snippetsOnly: external_exports.boolean().optional().describe("Reduce each message to its id, labels, snippet, and key headers (From/To/Cc/Subject/Date), dropping full bodies"),
       outDir: external_exports.string().optional().describe("Directory to write attachments to (default: current directory)"),
       account: accountParam
     }
-  }, async ({ threadId, download, full, sanitizeContent, outDir, account }) => {
+  }, async ({ threadId, download, full, sanitizeContent, latestN, snippetsOnly, outDir, account }) => {
     const args = ["gmail", "thread", "get", threadId];
     if (download) args.push("--download");
     if (full) args.push("--full");
     if (sanitizeContent) args.push("--sanitize-content");
     if (outDir) args.push(`--out-dir=${outDir}`);
-    return runOrDiagnose(args, { account });
+    const result = await runOrDiagnose(args, { account });
+    if (latestN === void 0 && !snippetsOnly) return result;
+    return trimThread(result, latestN, snippetsOnly);
   });
   server2.registerTool("gog_gmail_thread_modify", {
     description: "Modify labels on all messages in a thread (add and/or remove labels).",
@@ -31577,12 +31633,16 @@ function registerExtraGmailTools(server2) {
     quote: external_exports.boolean().optional().describe("Include quoted original message in reply (requires replyToMessageId)"),
     attach: external_exports.array(external_exports.string()).optional().describe("Attachment file paths (repeatable)"),
     from: external_exports.string().optional().describe("Send from this email address (must be a verified send-as alias)"),
+    omitRecipients: external_exports.boolean().optional().describe("Create the draft with no recipients even if to/cc/bcc are supplied \u2014 an accidental-send guard. Populate recipients in a later update before sending."),
+    returnFull: external_exports.boolean().optional().describe("After writing, re-fetch and return the full stored draft (subject, body, recipients) instead of just the write acknowledgement. Costs one extra read."),
     account: accountParam
   };
   function appendDraftFlags(args, f) {
-    if (f.to) args.push(`--to=${f.to}`);
-    if (f.cc) args.push(`--cc=${f.cc}`);
-    if (f.bcc) args.push(`--bcc=${f.bcc}`);
+    if (!f.omitRecipients) {
+      if (f.to) args.push(`--to=${f.to}`);
+      if (f.cc) args.push(`--cc=${f.cc}`);
+      if (f.bcc) args.push(`--bcc=${f.bcc}`);
+    }
     args.push(`--subject=${f.subject}`);
     args.push(`--body=${f.body}`);
     if (f.bodyHtml) args.push(`--body-html=${f.bodyHtml}`);
@@ -31592,13 +31652,26 @@ function registerExtraGmailTools(server2) {
     if (f.attach) for (const path of f.attach) args.push(`--attach=${path}`);
     if (f.from) args.push(`--from=${f.from}`);
   }
+  async function writeDraft(args, account, returnFull, knownDraftId) {
+    const result = await runOrDiagnose(args, { account });
+    if (!returnFull) return result;
+    let parsed;
+    try {
+      parsed = JSON.parse(result.content[0].text);
+    } catch {
+      return result;
+    }
+    const draftId = knownDraftId ?? parsed.draftId;
+    if (!draftId) return result;
+    return runOrDiagnose(["gmail", "drafts", "get", draftId], { account });
+  }
   server2.registerTool("gog_gmail_drafts_create", {
-    description: "Create a new Gmail draft.",
+    description: "Create a new Gmail draft. Recipients (to/cc/bcc) are optional; omit them (or set omitRecipients) to create a recipient-less draft as an accidental-send guard.",
     inputSchema: draftWriteSchema
-  }, async ({ account, ...flags }) => {
+  }, async ({ account, returnFull, ...flags }) => {
     const args = ["gmail", "drafts", "create"];
     appendDraftFlags(args, flags);
-    return runOrDiagnose(args, { account });
+    return writeDraft(args, account, returnFull);
   });
   server2.registerTool("gog_gmail_drafts_update", {
     description: "Update an existing Gmail draft.",
@@ -31607,20 +31680,23 @@ function registerExtraGmailTools(server2) {
       draftId: external_exports.string().describe("Draft ID"),
       ...draftWriteSchema
     }
-  }, async ({ draftId, account, ...flags }) => {
+  }, async ({ draftId, account, returnFull, ...flags }) => {
     const args = ["gmail", "drafts", "update", draftId];
     appendDraftFlags(args, flags);
-    return runOrDiagnose(args, { account });
+    return writeDraft(args, account, returnFull, draftId);
   });
   server2.registerTool("gog_gmail_drafts_delete", {
-    description: "Delete a Gmail draft.",
+    description: "Permanently delete a Gmail draft (not reversible \u2014 drafts do not go to Trash). Requires force:true to delete non-interactively.",
     annotations: { destructiveHint: true },
     inputSchema: {
       draftId: external_exports.string().describe("Draft ID"),
+      force: external_exports.boolean().optional().describe("Required to delete in this non-interactive context \u2014 without it the delete is refused as a safety guard."),
       account: accountParam
     }
-  }, async ({ draftId, account }) => {
-    return runOrDiagnose(["gmail", "drafts", "delete", draftId], { account });
+  }, async ({ draftId, account, force }) => {
+    const args = ["gmail", "drafts", "delete", draftId];
+    if (force) args.push("--force");
+    return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_gmail_drafts_send", {
     description: "Send an existing Gmail draft.",
@@ -31687,6 +31763,225 @@ function registerExtraGmailTools(server2) {
     if (allowSelf) args.push("--allow-self");
     return runOrDiagnose(args, { account });
   });
+  server2.registerTool("gog_gmail_messages_search", {
+    description: "Search individual messages (not threads) using Gmail query syntax. Returns one result per matching message.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: external_exports.string().describe('Gmail search query (e.g. "from:alice is:unread has:attachment")'),
+      max: external_exports.number().optional().describe("Max results"),
+      page: external_exports.string().optional().describe("Page token"),
+      all: external_exports.boolean().optional().describe("Fetch all pages"),
+      includeBody: external_exports.boolean().optional().describe("Include the decoded message body in each result"),
+      full: external_exports.boolean().optional().describe("Show full message bodies without truncation (implies includeBody)"),
+      bodyFormat: external_exports.enum(["text", "html"]).optional().describe("Body format preference when includeBody is set"),
+      account: accountParam
+    }
+  }, async ({ query, max, page, all, includeBody, full, bodyFormat, account }) => {
+    const args = ["gmail", "messages", "search", query];
+    if (max !== void 0) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push("--all");
+    if (includeBody) args.push("--include-body");
+    if (full) args.push("--full");
+    if (bodyFormat) args.push(`--body-format=${bodyFormat}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_gmail_labels_style", {
+    description: "Change a user label's color or visibility (background/text color from Gmail's palette, label-list and message-list visibility).",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      labelIdOrName: external_exports.string().describe("Label ID or name to restyle"),
+      backgroundColor: external_exports.string().optional().describe("Background color from Gmail's label palette as #RRGGBB"),
+      textColor: external_exports.string().optional().describe("Text color from Gmail's label palette as #RRGGBB"),
+      labelListVisibility: external_exports.enum(["labelShow", "labelShowIfUnread", "labelHide"]).optional().describe("Label-list visibility"),
+      messageListVisibility: external_exports.enum(["show", "hide"]).optional().describe("Message-list visibility"),
+      account: accountParam
+    }
+  }, async ({ labelIdOrName, backgroundColor, textColor, labelListVisibility, messageListVisibility, account }) => {
+    const args = ["gmail", "labels", "style", labelIdOrName];
+    if (backgroundColor) args.push(`--background-color=${backgroundColor}`);
+    if (textColor) args.push(`--text-color=${textColor}`);
+    if (labelListVisibility) args.push(`--label-list-visibility=${labelListVisibility}`);
+    if (messageListVisibility) args.push(`--message-list-visibility=${messageListVisibility}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_gmail_vacation_get", {
+    description: "Get the current vacation responder (auto-reply) settings.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      account: accountParam
+    }
+  }, async ({ account }) => {
+    return runOrDiagnose(["gmail", "settings", "vacation", "get"], { account });
+  });
+  server2.registerTool("gog_gmail_vacation_update", {
+    description: "Update the vacation responder. Pass enable (with subject/body) to turn it on, or disable to turn it off; optional start/end RFC3339 times and contactsOnly/domainOnly scoping.",
+    inputSchema: {
+      enable: external_exports.boolean().optional().describe("Enable the vacation responder"),
+      disable: external_exports.boolean().optional().describe("Disable the vacation responder"),
+      subject: external_exports.string().optional().describe("Subject line for the auto-reply"),
+      body: external_exports.string().optional().describe("HTML body of the auto-reply message"),
+      start: external_exports.string().optional().describe("Start time in RFC3339 format (e.g. 2024-12-20T00:00:00Z)"),
+      end: external_exports.string().optional().describe("End time in RFC3339 format (e.g. 2024-12-31T23:59:59Z)"),
+      contactsOnly: external_exports.boolean().optional().describe("Only respond to contacts"),
+      domainOnly: external_exports.boolean().optional().describe("Only respond to senders in the same domain"),
+      account: accountParam
+    }
+  }, async ({ enable, disable, subject, body, start, end, contactsOnly, domainOnly, account }) => {
+    const args = ["gmail", "settings", "vacation", "update"];
+    if (enable) args.push("--enable");
+    if (disable) args.push("--disable");
+    if (subject) args.push(`--subject=${subject}`);
+    if (body) args.push(`--body=${body}`);
+    if (start) args.push(`--start=${start}`);
+    if (end) args.push(`--end=${end}`);
+    if (contactsOnly) args.push("--contacts-only");
+    if (domainOnly) args.push("--domain-only");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_gmail_filters_list", {
+    description: "List all Gmail filters for the account.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      account: accountParam
+    }
+  }, async ({ account }) => {
+    return runOrDiagnose(["gmail", "settings", "filters", "list"], { account });
+  });
+  server2.registerTool("gog_gmail_filters_get", {
+    description: "Get the criteria and actions of a single Gmail filter by ID.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      filterId: external_exports.string().describe("Filter ID"),
+      account: accountParam
+    }
+  }, async ({ filterId, account }) => {
+    return runOrDiagnose(["gmail", "settings", "filters", "get", filterId], { account });
+  });
+  server2.registerTool("gog_gmail_filters_create", {
+    description: "Create a Gmail filter. Specify match criteria (from/to/subject/query/hasAttachment) and one or more actions (label, archive, mark-read, star, important, trash, forward, never-spam).",
+    inputSchema: {
+      from: external_exports.string().optional().describe("Match messages from this sender"),
+      to: external_exports.string().optional().describe("Match messages to this recipient"),
+      subject: external_exports.string().optional().describe("Match messages with this subject"),
+      query: external_exports.string().optional().describe("Advanced Gmail search query for matching"),
+      hasAttachment: external_exports.boolean().optional().describe("Match messages with attachments"),
+      addLabel: external_exports.string().optional().describe("Label(s) to add to matching messages (comma-separated, name or ID)"),
+      removeLabel: external_exports.string().optional().describe("Label(s) to remove from matching messages (comma-separated, name or ID)"),
+      archive: external_exports.boolean().optional().describe("Archive matching messages (skip inbox)"),
+      markRead: external_exports.boolean().optional().describe("Mark matching messages as read"),
+      star: external_exports.boolean().optional().describe("Star matching messages"),
+      important: external_exports.boolean().optional().describe("Mark as important"),
+      trash: external_exports.boolean().optional().describe("Move matching messages to trash"),
+      neverSpam: external_exports.boolean().optional().describe("Never mark as spam"),
+      forward: external_exports.string().optional().describe("Forward to this email address (must be a verified forwarding address)"),
+      account: accountParam
+    }
+  }, async ({ from, to, subject, query, hasAttachment, addLabel, removeLabel, archive, markRead, star, important, trash, neverSpam, forward, account }) => {
+    const args = ["gmail", "settings", "filters", "create"];
+    if (from) args.push(`--from=${from}`);
+    if (to) args.push(`--to=${to}`);
+    if (subject) args.push(`--subject=${subject}`);
+    if (query) args.push(`--query=${query}`);
+    if (hasAttachment) args.push("--has-attachment");
+    if (addLabel) args.push(`--add-label=${addLabel}`);
+    if (removeLabel) args.push(`--remove-label=${removeLabel}`);
+    if (archive) args.push("--archive");
+    if (markRead) args.push("--mark-read");
+    if (star) args.push("--star");
+    if (important) args.push("--important");
+    if (trash) args.push("--trash");
+    if (neverSpam) args.push("--never-spam");
+    if (forward) args.push(`--forward=${forward}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_gmail_filters_delete", {
+    description: "Delete a Gmail filter by ID.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      filterId: external_exports.string().describe("Filter ID to delete"),
+      account: accountParam
+    }
+  }, async ({ filterId, account }) => {
+    return runOrDiagnose(["gmail", "settings", "filters", "delete", filterId], { account });
+  });
+  server2.registerTool("gog_gmail_sendas_list", {
+    description: "List all send-as aliases configured for the account.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      account: accountParam
+    }
+  }, async ({ account }) => {
+    return runOrDiagnose(["gmail", "settings", "sendas", "list"], { account });
+  });
+  server2.registerTool("gog_gmail_sendas_get", {
+    description: "Get details of a single send-as alias by its email address.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      email: external_exports.string().describe("Send-as alias email address"),
+      account: accountParam
+    }
+  }, async ({ email: email3, account }) => {
+    return runOrDiagnose(["gmail", "settings", "sendas", "get", email3], { account });
+  });
+  server2.registerTool("gog_gmail_sendas_create", {
+    description: "Create a send-as alias. Newly added aliases generally require email verification before they can be used (see gog_gmail_sendas_verify).",
+    inputSchema: {
+      email: external_exports.string().describe("Email address of the new send-as alias"),
+      displayName: external_exports.string().optional().describe("Name that appears in the From field"),
+      replyTo: external_exports.string().optional().describe("Reply-to address"),
+      signature: external_exports.string().optional().describe("HTML signature for emails sent from this alias"),
+      treatAsAlias: external_exports.boolean().optional().describe("Treat as alias (replies sent from Gmail web)"),
+      account: accountParam
+    }
+  }, async ({ email: email3, displayName, replyTo, signature, treatAsAlias, account }) => {
+    const args = ["gmail", "settings", "sendas", "create", email3];
+    if (displayName) args.push(`--display-name=${displayName}`);
+    if (replyTo) args.push(`--reply-to=${replyTo}`);
+    if (signature) args.push(`--signature=${signature}`);
+    if (treatAsAlias) args.push("--treat-as-alias");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_gmail_sendas_update", {
+    description: "Update a send-as alias (display name, reply-to, signature, alias handling, or make it the default).",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      email: external_exports.string().describe("Send-as alias email address to update"),
+      displayName: external_exports.string().optional().describe("Name that appears in the From field"),
+      replyTo: external_exports.string().optional().describe("Reply-to address"),
+      signature: external_exports.string().optional().describe("HTML signature"),
+      treatAsAlias: external_exports.boolean().optional().describe("Treat as alias"),
+      makeDefault: external_exports.boolean().optional().describe("Make this the default send-as address"),
+      account: accountParam
+    }
+  }, async ({ email: email3, displayName, replyTo, signature, treatAsAlias, makeDefault, account }) => {
+    const args = ["gmail", "settings", "sendas", "update", email3];
+    if (displayName) args.push(`--display-name=${displayName}`);
+    if (replyTo) args.push(`--reply-to=${replyTo}`);
+    if (signature) args.push(`--signature=${signature}`);
+    if (treatAsAlias) args.push("--treat-as-alias");
+    if (makeDefault) args.push("--make-default");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_gmail_sendas_delete", {
+    description: "Delete a send-as alias by its email address.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      email: external_exports.string().describe("Send-as alias email address to delete"),
+      account: accountParam
+    }
+  }, async ({ email: email3, account }) => {
+    return runOrDiagnose(["gmail", "settings", "sendas", "delete", email3], { account });
+  });
+  server2.registerTool("gog_gmail_sendas_verify", {
+    description: "Resend the verification email for a send-as alias that is pending verification.",
+    inputSchema: {
+      email: external_exports.string().describe("Send-as alias email address to verify"),
+      account: accountParam
+    }
+  }, async ({ email: email3, account }) => {
+    return runOrDiagnose(["gmail", "settings", "sendas", "verify", email3], { account });
+  });
 }
 
 // src/index.ts

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-gmail",
   "display_name": "gogcli (Gmail)",
-  "version": "2.0.12",
+  "version": "2.3.0",
   "description": "Extended Gmail for Claude via gogcli — auth + full Gmail support (threads, labels, drafts, attachments, forward, autoreply, bulk operations)",
   "author": {
     "name": "Chris Hall",
@@ -204,6 +204,62 @@
     {
       "name": "gog_gmail_autoreply",
       "description": "Reply once to all messages matching a Gmail search query"
+    },
+    {
+      "name": "gog_gmail_messages_search",
+      "description": "Search individual messages (not threads) using Gmail query syntax"
+    },
+    {
+      "name": "gog_gmail_labels_style",
+      "description": "Change a user label's color or visibility"
+    },
+    {
+      "name": "gog_gmail_vacation_get",
+      "description": "Get the current vacation responder settings"
+    },
+    {
+      "name": "gog_gmail_vacation_update",
+      "description": "Enable, disable, or update the vacation responder"
+    },
+    {
+      "name": "gog_gmail_filters_list",
+      "description": "List all Gmail filters"
+    },
+    {
+      "name": "gog_gmail_filters_get",
+      "description": "Get a single Gmail filter's criteria and actions"
+    },
+    {
+      "name": "gog_gmail_filters_create",
+      "description": "Create a Gmail filter with match criteria and actions"
+    },
+    {
+      "name": "gog_gmail_filters_delete",
+      "description": "Delete a Gmail filter by ID"
+    },
+    {
+      "name": "gog_gmail_sendas_list",
+      "description": "List all send-as aliases for the account"
+    },
+    {
+      "name": "gog_gmail_sendas_get",
+      "description": "Get details of a single send-as alias"
+    },
+    {
+      "name": "gog_gmail_sendas_create",
+      "description": "Create a send-as alias"
+    },
+    {
+      "name": "gog_gmail_sendas_update",
+      "description": "Update a send-as alias or make it the default"
+    },
+    {
+      "name": "gog_gmail_sendas_delete",
+      "description": "Delete a send-as alias"
+    },
+    {
+      "name": "gog_gmail_sendas_verify",
+      "description": "Resend the verification email for a send-as alias"
     }
   ],
   "compatibility": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-gmail",
-  "version": "2.0.12",
+  "version": "2.3.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>",