gogcli-mcp-docs 2.3.0 → 2.4.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Extended Google Docs for Claude via gogcli — auth + full Docs and comments support",
-    "version": "2.3.0"
+    "version": "2.4.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli (Docs)",
       "source": "./",
       "description": "Extended Google Docs for Claude via gogcli — auth + full Docs and comments support",
-      "version": "2.3.0",
+      "version": "2.4.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp-docs",
   "displayName": "gogcli (Docs)",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Extended Google Docs for Claude via gogcli — auth + full Docs and comments support",
   "author": {
     "name": "Chris Hall",

package/dist/index.js

@@ -31313,7 +31313,7 @@ var failIfNotEmptyParam = external_exports.boolean().optional().describe(
 );
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.3.0" : "0.0.0";
+var VERSION = true ? "2.4.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31543,15 +31543,19 @@ function registerExtraDocsTools(server2) {
       text: external_exports.string().optional().describe("Text content to write"),
       file: external_exports.string().optional().describe("Path to a file whose content to use"),
       index: external_exports.number().optional().describe("Character index to insert at"),
+      replaceRange: external_exports.string().optional().describe('Replace a UTF-16 Docs API range START:END (e.g. "25:40") instead of inserting at index. The replacement text/file content overwrites the range.'),
+      markdown: external_exports.boolean().optional().describe("Convert markdown in the text/file to Google Docs formatting (headings, bold, lists, etc.) instead of inserting it literally."),
       tabId: external_exports.string().optional().describe("Tab ID for multi-tab docs"),
       pageless: external_exports.boolean().optional().describe("Set document to pageless format"),
       account: accountParam
     }
-  }, async ({ docId, text, file: file2, index, tabId, pageless, account }) => {
+  }, async ({ docId, text, file: file2, index, replaceRange, markdown, tabId, pageless, account }) => {
     const args = ["docs", "update", docId];
     if (text) args.push(`--text=${text}`);
     if (file2) args.push(`--file=${file2}`);
     if (index !== void 0) args.push(`--index=${index}`);
+    if (replaceRange) args.push(`--replace-range=${replaceRange}`);
+    if (markdown) args.push("--markdown");
     if (tabId) args.push(`--tab-id=${tabId}`);
     if (pageless) args.push("--pageless");
     return runOrDiagnose(args, { account });
@@ -31663,11 +31667,25 @@ function registerExtraDocsTools(server2) {
     inputSchema: {
       docId: external_exports.string().describe("Doc ID (from the URL)"),
       layout: external_exports.enum(["pageless", "pages"]).optional().describe("Page layout (default: pageless)"),
+      pageSize: external_exports.enum(["A4", "A5", "Letter", "Legal", "Tabloid"]).optional().describe("Named page size preset (only applies in paged layout)"),
+      pageWidth: external_exports.string().optional().describe('Page width (points by default; supports pt, in, cm, mm \u2014 e.g. "8.5in")'),
+      pageHeight: external_exports.string().optional().describe("Page height (points by default; supports pt, in, cm, mm)"),
+      marginTop: external_exports.string().optional().describe("Top page margin (points by default; supports pt, in, cm, mm)"),
+      marginBottom: external_exports.string().optional().describe("Bottom page margin (points by default; supports pt, in, cm, mm)"),
+      marginLeft: external_exports.string().optional().describe("Left page margin (points by default; supports pt, in, cm, mm)"),
+      marginRight: external_exports.string().optional().describe("Right page margin (points by default; supports pt, in, cm, mm)"),
       account: accountParam
     }
-  }, async ({ docId, layout, account }) => {
+  }, async ({ docId, layout, pageSize, pageWidth, pageHeight, marginTop, marginBottom, marginLeft, marginRight, account }) => {
     const args = ["docs", "page-layout", docId];
     if (layout) args.push(`--layout=${layout}`);
+    if (pageSize) args.push(`--page-size=${pageSize}`);
+    if (pageWidth) args.push(`--page-width=${pageWidth}`);
+    if (pageHeight) args.push(`--page-height=${pageHeight}`);
+    if (marginTop) args.push(`--margin-top=${marginTop}`);
+    if (marginBottom) args.push(`--margin-bottom=${marginBottom}`);
+    if (marginLeft) args.push(`--margin-left=${marginLeft}`);
+    if (marginRight) args.push(`--margin-right=${marginRight}`);
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_docs_insert_table", {
@@ -31691,6 +31709,127 @@ function registerExtraDocsTools(server2) {
     if (tab) args.push(`--tab=${tab}`);
     return runOrDiagnose(args, { account });
   });
+  server2.registerTool("gog_docs_cell_update", {
+    description: "Replace (or append to) the content of a single table cell, addressed by table / row / column \u2014 non-destructive to the rest of the table, unlike index-based edits that shift on every change. Provide content inline or read it from contentFile. Note: row/col/tableIndex are 1-based here; the sibling gog_docs_cell_style uses 0-based addressing.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      row: external_exports.number().int().describe("1-based row number"),
+      col: external_exports.number().int().describe("1-based column number"),
+      content: external_exports.string().optional().describe("Replacement content (omit when using contentFile)"),
+      contentFile: external_exports.string().optional().describe("Read replacement content from a file instead of content"),
+      append: external_exports.boolean().optional().describe("Append inside the cell instead of replacing existing cell content"),
+      format: external_exports.enum(["markdown", "plain"]).optional().describe("Content format (default: markdown)"),
+      tableIndex: external_exports.number().int().optional().describe("1-based table index in document order; negative counts from the end (default: 1)"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, row, col, content, contentFile, append, format, tableIndex, tab, account }) => {
+    const args = ["docs", "cell-update", docId, `--row=${row}`, `--col=${col}`];
+    if (content !== void 0) args.push(`--content=${content}`);
+    if (contentFile) args.push(`--content-file=${contentFile}`);
+    if (append) args.push("--append");
+    if (format) args.push(`--format=${format}`);
+    if (tableIndex !== void 0) args.push(`--table-index=${tableIndex}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_cell_style", {
+    description: "Apply background color and/or inline text styling (bold, italic, underline, colors) to one or more table cells, addressed by 0-based row/column with optional spans. Sibling to gog_docs_cell_update, which changes cell content rather than styling. Note: row/col/tableIndex are 0-based here; gog_docs_cell_update uses 1-based addressing.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      row: external_exports.number().int().describe("0-based row number"),
+      col: external_exports.number().int().describe("0-based column number"),
+      rowSpan: external_exports.number().int().optional().describe("Number of rows to style (default: 1)"),
+      colSpan: external_exports.number().int().optional().describe("Number of columns to style (default: 1)"),
+      backgroundColor: external_exports.string().optional().describe("Cell background color as #RRGGBB or #RGB"),
+      textColor: external_exports.string().optional().describe("Text color as #RRGGBB or #RGB"),
+      bold: external_exports.boolean().optional().describe("Set cell text bold"),
+      italic: external_exports.boolean().optional().describe("Set cell text italic"),
+      underline: external_exports.boolean().optional().describe("Set cell text underline"),
+      tableIndex: external_exports.number().int().optional().describe("0-based table index in document order (default: 0)"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, row, col, rowSpan, colSpan, backgroundColor, textColor, bold, italic, underline, tableIndex, tab, account }) => {
+    const args = ["docs", "cell-style", docId, `--row=${row}`, `--col=${col}`];
+    if (rowSpan !== void 0) args.push(`--row-span=${rowSpan}`);
+    if (colSpan !== void 0) args.push(`--col-span=${colSpan}`);
+    if (backgroundColor) args.push(`--background-color=${backgroundColor}`);
+    if (textColor) args.push(`--text-color=${textColor}`);
+    if (bold) args.push("--bold");
+    if (italic) args.push("--italic");
+    if (underline) args.push("--underline");
+    if (tableIndex !== void 0) args.push(`--table-index=${tableIndex}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_insert_image", {
+    description: "Upload a local image (PNG, JPEG, or GIF) and insert it into a Google Doc. The image is uploaded to Drive, temporarily shared so Docs can fetch it, inserted, then the public permission is revoked. Replaces placeholder text (at) or appends at end-of-doc.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      file: external_exports.string().describe("Local PNG, JPEG, or GIF image to upload and insert"),
+      at: external_exports.string().optional().describe('Placeholder text to replace, or "end" to append (default: end)'),
+      width: external_exports.number().optional().describe("Image width in points (default: 468)"),
+      height: external_exports.number().optional().describe("Image height in points (optional; width-only preserves aspect ratio)"),
+      name: external_exports.string().optional().describe("Override the uploaded Drive filename"),
+      parent: external_exports.string().optional().describe("Drive folder ID for the uploaded image"),
+      onRestricted: external_exports.enum(["error", "link"]).optional().describe("If public sharing is blocked: error out, or fall back to a linked image (default: error)"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, file: file2, at, width, height, name, parent, onRestricted, tab, account }) => {
+    const args = ["docs", "insert-image", docId, `--file=${file2}`];
+    if (at) args.push(`--at=${at}`);
+    if (width !== void 0) args.push(`--width=${width}`);
+    if (height !== void 0) args.push(`--height=${height}`);
+    if (name) args.push(`--name=${name}`);
+    if (parent) args.push(`--parent=${parent}`);
+    if (onRestricted) args.push(`--on-restricted=${onRestricted}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_insert_person", {
+    description: "Insert a native Google Docs person smart chip (the interactive @-mention chip) for an email address, at a character index or end-of-doc.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      email: external_exports.string().describe("Email address for the person chip"),
+      index: external_exports.number().int().optional().describe("Character index to insert at. Omit or use atEnd for end-of-doc."),
+      atEnd: external_exports.boolean().optional().describe("Insert at end-of-doc/tab (mutually exclusive with index)"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, email: email3, index, atEnd, tab, account }) => {
+    const args = ["docs", "insert-person", docId, `--email=${email3}`];
+    if (index !== void 0) args.push(`--index=${index}`);
+    if (atEnd) args.push("--at-end");
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_insert_date_chip", {
+    description: "Insert a native Google Docs date smart chip, at a character index or end-of-doc.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      date: external_exports.string().optional().describe("Date to insert as YYYY-MM-DD (default: today)"),
+      format: external_exports.enum(["abbreviated", "full", "iso"]).optional().describe("Date display format (default: abbreviated)"),
+      index: external_exports.number().int().optional().describe("Character index to insert at. Omit or use atEnd for end-of-doc."),
+      atEnd: external_exports.boolean().optional().describe("Insert at end-of-doc/tab (mutually exclusive with index)"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, date: date5, format, index, atEnd, tab, account }) => {
+    const args = ["docs", "insert-date-chip", docId];
+    if (date5) args.push(`--date=${date5}`);
+    if (format) args.push(`--format=${format}`);
+    if (index !== void 0) args.push(`--index=${index}`);
+    if (atEnd) args.push("--at-end");
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
   server2.registerTool("gog_docs_add_tab", {
     description: "Add a tab to a Google Doc. Tabs partition a doc into independently-addressable sections (multi-tab docs). Optionally set the title, zero-based position, parent tab (for nesting), and an emoji icon.",
     inputSchema: {

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-docs",
   "display_name": "gogcli (Docs)",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Extended Google Docs for Claude via gogcli — auth + full Docs and comments support",
   "author": {
     "name": "Chris Hall",
@@ -206,6 +206,26 @@
     {
       "name": "gog_docs_insert_table",
       "description": "Insert a native Google Docs table with given dimensions, optionally populated from a JSON 2D array."
+    },
+    {
+      "name": "gog_docs_cell_update",
+      "description": "Replace or append the content of a single table cell, addressed by table/row/column."
+    },
+    {
+      "name": "gog_docs_cell_style",
+      "description": "Apply background color and inline text styling to one or more table cells."
+    },
+    {
+      "name": "gog_docs_insert_image",
+      "description": "Upload a local image and insert it into a Google Doc."
+    },
+    {
+      "name": "gog_docs_insert_person",
+      "description": "Insert a native Google Docs person smart chip for an email address."
+    },
+    {
+      "name": "gog_docs_insert_date_chip",
+      "description": "Insert a native Google Docs date smart chip."
     }
   ],
   "compatibility": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-docs",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "mcpName": "io.github.chrischall/gogcli-mcp-docs",
   "description": "Extended Google Docs MCP server via gogcli — all base tools plus full Docs support",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

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

package/src/tools/docs-extra.ts

@@ -253,15 +253,19 @@ export function registerExtraDocsTools(server: McpServer): void {
       text: z.string().optional().describe('Text content to write'),
       file: z.string().optional().describe('Path to a file whose content to use'),
       index: z.number().optional().describe('Character index to insert at'),
+      replaceRange: z.string().optional().describe('Replace a UTF-16 Docs API range START:END (e.g. "25:40") instead of inserting at index. The replacement text/file content overwrites the range.'),
+      markdown: z.boolean().optional().describe('Convert markdown in the text/file to Google Docs formatting (headings, bold, lists, etc.) instead of inserting it literally.'),
       tabId: z.string().optional().describe('Tab ID for multi-tab docs'),
       pageless: z.boolean().optional().describe('Set document to pageless format'),
       account: accountParam,
     },
-  }, async ({ docId, text, file, index, tabId, pageless, account }) => {
+  }, async ({ docId, text, file, index, replaceRange, markdown, tabId, pageless, account }) => {
     const args = ['docs', 'update', docId];
     if (text) args.push(`--text=${text}`);
     if (file) args.push(`--file=${file}`);
     if (index !== undefined) args.push(`--index=${index}`);
+    if (replaceRange) args.push(`--replace-range=${replaceRange}`);
+    if (markdown) args.push('--markdown');
     if (tabId) args.push(`--tab-id=${tabId}`);
     if (pageless) args.push('--pageless');
     return runOrDiagnose(args, { account });
@@ -385,11 +389,25 @@ export function registerExtraDocsTools(server: McpServer): void {
     inputSchema: {
       docId: z.string().describe('Doc ID (from the URL)'),
       layout: z.enum(['pageless', 'pages']).optional().describe('Page layout (default: pageless)'),
+      pageSize: z.enum(['A4', 'A5', 'Letter', 'Legal', 'Tabloid']).optional().describe('Named page size preset (only applies in paged layout)'),
+      pageWidth: z.string().optional().describe('Page width (points by default; supports pt, in, cm, mm — e.g. "8.5in")'),
+      pageHeight: z.string().optional().describe('Page height (points by default; supports pt, in, cm, mm)'),
+      marginTop: z.string().optional().describe('Top page margin (points by default; supports pt, in, cm, mm)'),
+      marginBottom: z.string().optional().describe('Bottom page margin (points by default; supports pt, in, cm, mm)'),
+      marginLeft: z.string().optional().describe('Left page margin (points by default; supports pt, in, cm, mm)'),
+      marginRight: z.string().optional().describe('Right page margin (points by default; supports pt, in, cm, mm)'),
       account: accountParam,
     },
-  }, async ({ docId, layout, account }) => {
+  }, async ({ docId, layout, pageSize, pageWidth, pageHeight, marginTop, marginBottom, marginLeft, marginRight, account }) => {
     const args = ['docs', 'page-layout', docId];
     if (layout) args.push(`--layout=${layout}`);
+    if (pageSize) args.push(`--page-size=${pageSize}`);
+    if (pageWidth) args.push(`--page-width=${pageWidth}`);
+    if (pageHeight) args.push(`--page-height=${pageHeight}`);
+    if (marginTop) args.push(`--margin-top=${marginTop}`);
+    if (marginBottom) args.push(`--margin-bottom=${marginBottom}`);
+    if (marginLeft) args.push(`--margin-left=${marginLeft}`);
+    if (marginRight) args.push(`--margin-right=${marginRight}`);
     return runOrDiagnose(args, { account });
   });
 
@@ -415,6 +433,132 @@ export function registerExtraDocsTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  server.registerTool('gog_docs_cell_update', {
+    description: 'Replace (or append to) the content of a single table cell, addressed by table / row / column — non-destructive to the rest of the table, unlike index-based edits that shift on every change. Provide content inline or read it from contentFile. Note: row/col/tableIndex are 1-based here; the sibling gog_docs_cell_style uses 0-based addressing.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      row: z.number().int().describe('1-based row number'),
+      col: z.number().int().describe('1-based column number'),
+      content: z.string().optional().describe('Replacement content (omit when using contentFile)'),
+      contentFile: z.string().optional().describe('Read replacement content from a file instead of content'),
+      append: z.boolean().optional().describe('Append inside the cell instead of replacing existing cell content'),
+      format: z.enum(['markdown', 'plain']).optional().describe('Content format (default: markdown)'),
+      tableIndex: z.number().int().optional().describe('1-based table index in document order; negative counts from the end (default: 1)'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, row, col, content, contentFile, append, format, tableIndex, tab, account }) => {
+    const args = ['docs', 'cell-update', docId, `--row=${row}`, `--col=${col}`];
+    if (content !== undefined) args.push(`--content=${content}`);
+    if (contentFile) args.push(`--content-file=${contentFile}`);
+    if (append) args.push('--append');
+    if (format) args.push(`--format=${format}`);
+    if (tableIndex !== undefined) args.push(`--table-index=${tableIndex}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_cell_style', {
+    description: 'Apply background color and/or inline text styling (bold, italic, underline, colors) to one or more table cells, addressed by 0-based row/column with optional spans. Sibling to gog_docs_cell_update, which changes cell content rather than styling. Note: row/col/tableIndex are 0-based here; gog_docs_cell_update uses 1-based addressing.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      row: z.number().int().describe('0-based row number'),
+      col: z.number().int().describe('0-based column number'),
+      rowSpan: z.number().int().optional().describe('Number of rows to style (default: 1)'),
+      colSpan: z.number().int().optional().describe('Number of columns to style (default: 1)'),
+      backgroundColor: z.string().optional().describe('Cell background color as #RRGGBB or #RGB'),
+      textColor: z.string().optional().describe('Text color as #RRGGBB or #RGB'),
+      bold: z.boolean().optional().describe('Set cell text bold'),
+      italic: z.boolean().optional().describe('Set cell text italic'),
+      underline: z.boolean().optional().describe('Set cell text underline'),
+      tableIndex: z.number().int().optional().describe('0-based table index in document order (default: 0)'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, row, col, rowSpan, colSpan, backgroundColor, textColor, bold, italic, underline, tableIndex, tab, account }) => {
+    const args = ['docs', 'cell-style', docId, `--row=${row}`, `--col=${col}`];
+    if (rowSpan !== undefined) args.push(`--row-span=${rowSpan}`);
+    if (colSpan !== undefined) args.push(`--col-span=${colSpan}`);
+    if (backgroundColor) args.push(`--background-color=${backgroundColor}`);
+    if (textColor) args.push(`--text-color=${textColor}`);
+    if (bold) args.push('--bold');
+    if (italic) args.push('--italic');
+    if (underline) args.push('--underline');
+    if (tableIndex !== undefined) args.push(`--table-index=${tableIndex}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_insert_image', {
+    description: 'Upload a local image (PNG, JPEG, or GIF) and insert it into a Google Doc. The image is uploaded to Drive, temporarily shared so Docs can fetch it, inserted, then the public permission is revoked. Replaces placeholder text (at) or appends at end-of-doc.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      file: z.string().describe('Local PNG, JPEG, or GIF image to upload and insert'),
+      at: z.string().optional().describe('Placeholder text to replace, or "end" to append (default: end)'),
+      width: z.number().optional().describe('Image width in points (default: 468)'),
+      height: z.number().optional().describe('Image height in points (optional; width-only preserves aspect ratio)'),
+      name: z.string().optional().describe('Override the uploaded Drive filename'),
+      parent: z.string().optional().describe('Drive folder ID for the uploaded image'),
+      onRestricted: z.enum(['error', 'link']).optional().describe('If public sharing is blocked: error out, or fall back to a linked image (default: error)'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, file, at, width, height, name, parent, onRestricted, tab, account }) => {
+    const args = ['docs', 'insert-image', docId, `--file=${file}`];
+    if (at) args.push(`--at=${at}`);
+    if (width !== undefined) args.push(`--width=${width}`);
+    if (height !== undefined) args.push(`--height=${height}`);
+    if (name) args.push(`--name=${name}`);
+    if (parent) args.push(`--parent=${parent}`);
+    if (onRestricted) args.push(`--on-restricted=${onRestricted}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_insert_person', {
+    description: 'Insert a native Google Docs person smart chip (the interactive @-mention chip) for an email address, at a character index or end-of-doc.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      email: z.string().describe('Email address for the person chip'),
+      index: z.number().int().optional().describe('Character index to insert at. Omit or use atEnd for end-of-doc.'),
+      atEnd: z.boolean().optional().describe('Insert at end-of-doc/tab (mutually exclusive with index)'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, email, index, atEnd, tab, account }) => {
+    const args = ['docs', 'insert-person', docId, `--email=${email}`];
+    if (index !== undefined) args.push(`--index=${index}`);
+    if (atEnd) args.push('--at-end');
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_insert_date_chip', {
+    description: 'Insert a native Google Docs date smart chip, at a character index or end-of-doc.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      date: z.string().optional().describe('Date to insert as YYYY-MM-DD (default: today)'),
+      format: z.enum(['abbreviated', 'full', 'iso']).optional().describe('Date display format (default: abbreviated)'),
+      index: z.number().int().optional().describe('Character index to insert at. Omit or use atEnd for end-of-doc.'),
+      atEnd: z.boolean().optional().describe('Insert at end-of-doc/tab (mutually exclusive with index)'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, date, format, index, atEnd, tab, account }) => {
+    const args = ['docs', 'insert-date-chip', docId];
+    if (date) args.push(`--date=${date}`);
+    if (format) args.push(`--format=${format}`);
+    if (index !== undefined) args.push(`--index=${index}`);
+    if (atEnd) args.push('--at-end');
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
   server.registerTool('gog_docs_add_tab', {
     description: 'Add a tab to a Google Doc. Tabs partition a doc into independently-addressable sections (multi-tab docs). Optionally set the title, zero-based position, parent tab (for nesting), and an emoji icon.',
     inputSchema: {

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

@@ -378,6 +378,36 @@ describe('gog_docs_update', () => {
     await handlers.get('gog_docs_update')!({ docId: 'abc' });
     expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'update', 'abc'], { account: undefined });
   });
+
+  it('includes --replace-range when provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_update')!({ docId: 'abc', text: 'new', replaceRange: '25:40' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'update', 'abc', '--text=new', '--replace-range=25:40'],
+      { account: undefined },
+    );
+  });
+
+  it('includes --markdown when true', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_update')!({ docId: 'abc', text: '# Heading', markdown: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'update', 'abc', '--text=# Heading', '--markdown'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --markdown when false', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_update')!({ docId: 'abc', text: 'hi', markdown: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'update', 'abc', '--text=hi'],
+      { account: undefined },
+    );
+  });
 });
 
 // --- Dedicated comment tools ---
@@ -741,6 +771,160 @@ describe('gog_docs_page_layout', () => {
     await handlers.get('gog_docs_page_layout')!({ docId: 'd1' });
     expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'page-layout', 'd1'], { account: undefined });
   });
+
+  it('passes --page-size, page dimensions and all margins', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_page_layout')!({
+      docId: 'd1', layout: 'pages', pageSize: 'A4', pageWidth: '8.5in', pageHeight: '11in',
+      marginTop: '1in', marginBottom: '1in', marginLeft: '0.75in', marginRight: '0.75in',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'page-layout', 'd1', '--layout=pages', '--page-size=A4', '--page-width=8.5in',
+        '--page-height=11in', '--margin-top=1in', '--margin-bottom=1in', '--margin-left=0.75in', '--margin-right=0.75in'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_cell_update', () => {
+  it('passes required --row and --col', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_cell_update')!({ docId: 'd1', row: 2, col: 3, content: 'hi' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'cell-update', 'd1', '--row=2', '--col=3', '--content=hi'],
+      { account: undefined },
+    );
+  });
+
+  it('supports empty-string content, --content-file, --append, --format, --table-index and --tab', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_cell_update')!({
+      docId: 'd1', row: 1, col: 1, content: '', contentFile: '/tmp/c.md', append: true,
+      format: 'plain', tableIndex: -1, tab: 'Tab2',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'cell-update', 'd1', '--row=1', '--col=1', '--content=', '--content-file=/tmp/c.md',
+        '--append', '--format=plain', '--table-index=-1', '--tab=Tab2'],
+      { account: undefined },
+    );
+  });
+
+  it('omits content when not provided and forwards account', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_cell_update')!({ docId: 'd1', row: 1, col: 2, account: 'a@b.com' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'cell-update', 'd1', '--row=1', '--col=2'],
+      { account: 'a@b.com' },
+    );
+  });
+});
+
+describe('gog_docs_cell_style', () => {
+  it('passes required --row and --col', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_cell_style')!({ docId: 'd1', row: 0, col: 0 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'cell-style', 'd1', '--row=0', '--col=0'],
+      { account: undefined },
+    );
+  });
+
+  it('passes spans, colors and text styling', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_cell_style')!({
+      docId: 'd1', row: 1, col: 2, rowSpan: 2, colSpan: 3, backgroundColor: '#eee',
+      textColor: '#111', bold: true, italic: true, underline: true, tableIndex: 1, tab: 'T',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'cell-style', 'd1', '--row=1', '--col=2', '--row-span=2', '--col-span=3',
+        '--background-color=#eee', '--text-color=#111', '--bold', '--italic', '--underline',
+        '--table-index=1', '--tab=T'],
+      { account: undefined },
+    );
+  });
+
+  it('omits text styling flags when false', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_cell_style')!({ docId: 'd1', row: 0, col: 0, bold: false, italic: false, underline: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'cell-style', 'd1', '--row=0', '--col=0'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_insert_image', () => {
+  it('passes required --file and defaults', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_image')!({ docId: 'd1', file: '/tmp/pic.png' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-image', 'd1', '--file=/tmp/pic.png'],
+      { account: undefined },
+    );
+  });
+
+  it('passes placement, sizing, naming and restriction handling', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_image')!({
+      docId: 'd1', file: '/tmp/pic.png', at: '{{logo}}', width: 200, height: 100,
+      name: 'logo.png', parent: 'folder1', onRestricted: 'link', tab: 'T',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-image', 'd1', '--file=/tmp/pic.png', '--at={{logo}}', '--width=200',
+        '--height=100', '--name=logo.png', '--parent=folder1', '--on-restricted=link', '--tab=T'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_insert_person', () => {
+  it('passes required --email', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_person')!({ docId: 'd1', email: 'a@b.com' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-person', 'd1', '--email=a@b.com'],
+      { account: undefined },
+    );
+  });
+
+  it('passes --index, --at-end and --tab', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_person')!({ docId: 'd1', email: 'a@b.com', index: 0, atEnd: true, tab: 'T' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-person', 'd1', '--email=a@b.com', '--index=0', '--at-end', '--tab=T'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_insert_date_chip', () => {
+  it('omits all optional flags by default', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_date_chip')!({ docId: 'd1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'insert-date-chip', 'd1'], { account: undefined });
+  });
+
+  it('passes --date, --format, --index and --at-end', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_date_chip')!({ docId: 'd1', date: '2026-06-01', format: 'iso', index: 5, atEnd: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-date-chip', 'd1', '--date=2026-06-01', '--format=iso', '--index=5', '--at-end'],
+      { account: undefined },
+    );
+  });
 });
 
 describe('gog_docs_insert_table', () => {