gogcli-mcp-docs 2.0.10 → 2.0.12

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.0.10"
+    "version": "2.0.12"
   },
   "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.0.10",
+      "version": "2.0.12",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

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

package/README.md

@@ -3,11 +3,11 @@
 > [!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.
 
-Extended Google Docs [MCP](https://modelcontextprotocol.io) server via [gogcli](https://github.com/steipete/gogcli). Includes auth tools plus 14 additional dedicated Docs tools for editing, exporting, comments, and more.
+Extended Google Docs [MCP](https://modelcontextprotocol.io) server via [gogcli](https://github.com/openclaw/gogcli). Includes auth tools plus 18 additional dedicated Docs tools for editing, exporting, comments, and more.
 
 ## Requirements
 
-- [gogcli](https://github.com/steipete/gogcli) installed and authenticated
+- [gogcli](https://github.com/openclaw/gogcli) installed and authenticated
 - Node.js 18+
 
 ```bash
@@ -44,19 +44,23 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 claude mcp add gogcli-docs -- gogcli-mcp-docs
 ```
 
-## Extra Docs Tools (14)
+## Extra Docs Tools (18)
 
 Plus 5 auth tools and 7 base Docs tools (info, cat, create, write, find-replace, structure, run).
 
 | Tool | Description |
 |------|-------------|
+| `gog_docs_append` | Append text or markdown to the end of a doc |
 | `gog_docs_copy` | Copy a document |
 | `gog_docs_delete` | Delete content by character index range |
 | `gog_docs_edit` | Find and replace with case-sensitivity control |
 | `gog_docs_export` | Export as PDF, TXT, HTML, DOCX, RTF, ODT, or EPUB |
+| `gog_docs_format` | Apply character / paragraph formatting (bold, color, alignment, …) |
 | `gog_docs_insert` | Insert text at a specific position |
 | `gog_docs_list_tabs` | List all document tabs |
+| `gog_docs_read` | Read doc as plain text or raw JSON |
 | `gog_docs_sed` | Stream-edit with sed-like regex expressions |
+| `gog_docs_trash` | Move a doc to Drive trash |
 | `gog_docs_update` | Update document content at a specific position |
 | `gog_docs_comments_list` | List comments (open or resolved) |
 | `gog_docs_comments_get` | Get a comment with its replies |
@@ -65,6 +69,16 @@ Plus 5 auth tools and 7 base Docs tools (info, cat, create, write, find-replace,
 | `gog_docs_comments_resolve` | Resolve a comment |
 | `gog_docs_comments_delete` | Delete a comment |
 
+## Known limitations: `gog_docs_append` with `markdown: true`
+
+These bugs live in gogcli's upstream markdown → Docs converter; the wrapper just passes `--markdown` through. Tracked upstream:
+
+| Symptom | Workaround | Upstream |
+|---------|-----------|----------|
+| 3+ tables in one call reorders the trailing punctuation of the paragraph before the 3rd table | Split into multiple calls with ≤2 tables each | [openclaw/gogcli#607](https://github.com/openclaw/gogcli/issues/607) |
+| Inline `**bold**` / `*italic*` / `` `code` `` inside table cells renders as literal characters | Insert plain cell text, then apply formatting via `gog_docs_format` | [openclaw/gogcli#608](https://github.com/openclaw/gogcli/issues/608) |
+| Tables with an empty header row leak the last data row as literal pipe text | Always supply a non-empty header row | [openclaw/gogcli#609](https://github.com/openclaw/gogcli/issues/609) |
+
 ## License
 
 MIT

package/SKILL.md

@@ -5,13 +5,13 @@ description: Use when the user asks to read, write, edit, export, or comment on
 
 # gogcli-mcp-docs
 
-Extended Google Docs MCP server via [gogcli](https://github.com/steipete/gogcli) — 26 tools: auth + 7 base Docs + 14 extra dedicated Docs tools.
+Extended Google Docs MCP server via [gogcli](https://github.com/openclaw/gogcli) — 30 tools: auth + 7 base Docs + 18 extra dedicated Docs tools.
 
 - **Source:** [github.com/chrischall/gogcli-mcp](https://github.com/chrischall/gogcli-mcp)
 
 ## Requirements
 
-- [gogcli](https://github.com/steipete/gogcli) installed and authenticated
+- [gogcli](https://github.com/openclaw/gogcli) installed and authenticated
 - Node.js 18 or later
 
 ## Setup
@@ -34,13 +34,17 @@ Extended Google Docs MCP server via [gogcli](https://github.com/steipete/gogcli)
 
 | Tool | What it does |
 |------|-------------|
+| `gog_docs_append` | Append text or markdown to the end of a doc |
 | `gog_docs_copy` | Copy a document |
 | `gog_docs_delete` | Delete content by character index range |
 | `gog_docs_edit` | Find and replace with case-sensitivity |
 | `gog_docs_export` | Export as PDF, TXT, HTML, DOCX, RTF, ODT, or EPUB |
+| `gog_docs_format` | Apply character / paragraph formatting |
 | `gog_docs_insert` | Insert text at a specific position |
 | `gog_docs_list_tabs` | List all document tabs |
+| `gog_docs_read` | Read doc as plain text or raw JSON |
 | `gog_docs_sed` | Stream-edit with sed-like regex |
+| `gog_docs_trash` | Move a doc to Drive trash |
 | `gog_docs_update` | Update content at a specific position |
 | `gog_docs_comments_list` | List comments (open or resolved) |
 | `gog_docs_comments_get` | Get a comment with replies |
@@ -50,3 +54,11 @@ Extended Google Docs MCP server via [gogcli](https://github.com/steipete/gogcli)
 | `gog_docs_comments_delete` | Delete a comment |
 
 Plus 5 auth tools and 7 base Docs tools.
+
+### `gog_docs_append` with `markdown: true` — known limitations
+
+Three bugs in gogcli's upstream markdown→Docs converter to be aware of:
+
+- **3+ tables in one call** reorders the trailing punctuation of the paragraph before the 3rd table — split into multiple calls with ≤2 tables each ([openclaw/gogcli#607](https://github.com/openclaw/gogcli/issues/607)).
+- **Inline `**bold**` / `*italic*` / `` `code` `` inside table cells** renders as literal characters — insert plain cell text, then apply formatting via `gog_docs_format` ([openclaw/gogcli#608](https://github.com/openclaw/gogcli/issues/608)).
+- **Empty-header tables** leak the last data row as literal pipe text — always supply a non-empty header row ([openclaw/gogcli#609](https://github.com/openclaw/gogcli/issues/609)).

package/dist/index.js

@@ -31063,7 +31063,7 @@ async function run(args, options = {}) {
       settled = true;
       if (err.code === "ENOENT") {
         reject(new Error(
-          "gog executable not found. Install gogcli (https://github.com/steipete/gogcli) or set GOG_PATH in your MCP client config to the absolute binary path (run `which gog` in a terminal to find it)."
+          "gog executable not found. Install gogcli (https://github.com/openclaw/gogcli) or set GOG_PATH in your MCP client config to the absolute binary path (run `which gog` in a terminal to find it)."
         ));
         return;
       }
@@ -31292,7 +31292,7 @@ function registerDocsTools(server2) {
 var cellValueParam = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean(), external_exports.null()]);
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.0.10" : "0.0.0";
+var VERSION = true ? "2.0.12" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31399,6 +31399,8 @@ function registerExtraDocsTools(server2) {
       noStrikethrough: external_exports.boolean().optional().describe("Clear strikethrough"),
       alignment: external_exports.enum(["left", "center", "right", "justify", "start", "end", "justified"]).optional().describe("Paragraph alignment"),
       lineSpacing: external_exports.number().optional().describe("Line spacing percentage (e.g. 100 for single, 150 for 1.5x, 200 for double)"),
+      headingLevel: external_exports.number().int().optional().describe("Set paragraph named style to HEADING_1..HEADING_6 (shortcut for namedStyle=HEADING_N)"),
+      namedStyle: external_exports.enum(["NORMAL_TEXT", "TITLE", "SUBTITLE", "HEADING_1", "HEADING_2", "HEADING_3", "HEADING_4", "HEADING_5", "HEADING_6"]).optional().describe("Set paragraph named style explicitly"),
       account: accountParam
     }
   }, async (args) => {
@@ -31422,6 +31424,8 @@ function registerExtraDocsTools(server2) {
     if (a.noStrikethrough) argv.push("--no-strikethrough");
     if (a.alignment) argv.push(`--alignment=${a.alignment}`);
     if (a.lineSpacing !== void 0) argv.push(`--line-spacing=${a.lineSpacing}`);
+    if (a.headingLevel !== void 0) argv.push(`--heading-level=${a.headingLevel}`);
+    if (a.namedStyle) argv.push(`--named-style=${a.namedStyle}`);
     return runOrDiagnose(argv, { account: a.account });
   });
   server2.registerTool("gog_docs_export", {
@@ -31459,13 +31463,13 @@ function registerExtraDocsTools(server2) {
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_docs_append", {
-    description: "Append text to the end of a Google Doc. This is the right tool for iterative document construction \u2014 multiple sequential calls produce content in the order they were called. Use gog_docs_insert only when you need to insert at a specific character position.",
+    description: "Append text to the end of a Google Doc. This is the right tool for iterative document construction \u2014 multiple sequential calls produce content in the order they were called. Use gog_docs_insert only when you need to insert at a specific character position. Known markdown=true limitations (tracked upstream): (a) 3+ tables in one call reorders the trailing punctuation of the paragraph before the 3rd table \u2014 split into multiple calls with \u22642 tables each (openclaw/gogcli#607); (b) inline **bold** / *italic* / `code` inside table cells renders as literal characters \u2014 pre-format cell text separately or apply formatting after the append via gog_docs_format (openclaw/gogcli#608); (c) tables with an empty header row leak the last data row as literal pipe text \u2014 always supply a non-empty header (openclaw/gogcli#609).",
     annotations: { destructiveHint: true },
     inputSchema: {
       docId: external_exports.string().describe("Doc ID (from the URL)"),
       text: external_exports.string().optional().describe("Text content to append"),
       file: external_exports.string().optional().describe('Path to a text file to append (use "-" for stdin)'),
-      markdown: external_exports.boolean().optional().describe("Convert markdown to Google Docs formatting (headings, bold, lists, etc.)"),
+      markdown: external_exports.boolean().optional().describe("Convert markdown to Google Docs formatting (headings, bold, lists, etc.). See the tool description for known upstream limitations around tables."),
       tab: external_exports.string().optional().describe("Target tab title or ID (for multi-tab docs)"),
       account: accountParam
     }
@@ -31604,6 +31608,68 @@ function registerExtraDocsTools(server2) {
   }, async ({ docId, commentId, account }) => {
     return runOrDiagnose(["docs", "comments", "delete", docId, commentId], { account });
   });
+  server2.registerTool("gog_docs_comments_reopen", {
+    description: "Reopen a previously resolved comment (flip resolved \u2192 open).",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      commentId: external_exports.string().describe("Comment ID to reopen"),
+      account: accountParam
+    }
+  }, async ({ docId, commentId, account }) => {
+    return runOrDiagnose(["docs", "comments", "reopen", docId, commentId], { account });
+  });
+  server2.registerTool("gog_docs_insert_page_break", {
+    description: "Insert a Google Docs page break via InsertPageBreakRequest \u2014 the only path for multi-page deliverables (markdown has no page-break construct). Specify `index` for a precise character position, or `atEnd` for end-of-doc.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      index: external_exports.number().int().optional().describe("Character index to insert at (1 = beginning). 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, index, atEnd, tab, account }) => {
+    const args = ["docs", "insert-page-break", docId];
+    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_page_layout", {
+    description: "Toggle the page layout (pageless | pages) of an existing Google Doc. Sibling to the --pageless flag on docs create/write/update for docs that were already created (e.g. by Drive markdown conversion) without the desired layout.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      layout: external_exports.enum(["pageless", "pages"]).optional().describe("Page layout (default: pageless)"),
+      account: accountParam
+    }
+  }, async ({ docId, layout, account }) => {
+    const args = ["docs", "page-layout", docId];
+    if (layout) args.push(`--layout=${layout}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_insert_table", {
+    description: "Insert a native Google Docs table via InsertTableRequest, bypassing the markdown writer. Use this instead of writing a markdown table when you need precise dimensions or to avoid the markdown writer's table limitations. `valuesJson` is a JSON 2D string array whose dimensions must match rows x cols.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      rows: external_exports.number().int().min(1).describe("Number of rows (>=1)"),
+      cols: external_exports.number().int().min(1).describe("Number of columns (>=1)"),
+      index: external_exports.number().int().optional().describe("Character index to insert at (1 = beginning). Omit or use atEnd for end-of-doc."),
+      atEnd: external_exports.boolean().optional().describe("Insert at end-of-doc/tab (mutually exclusive with index)"),
+      valuesJson: external_exports.string().optional().describe("Cell values as a JSON 2D string array; dimensions must match rows x cols when supplied"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, rows, cols, index, atEnd, valuesJson, tab, account }) => {
+    const args = ["docs", "insert-table", docId, `--rows=${rows}`, `--cols=${cols}`];
+    if (index !== void 0) args.push(`--index=${index}`);
+    if (atEnd) args.push("--at-end");
+    if (valuesJson !== void 0) args.push(`--values-json=${valuesJson}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
 }
 
 // src/index.ts

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-docs",
   "display_name": "gogcli (Docs)",
-  "version": "2.0.10",
+  "version": "2.0.12",
   "description": "Extended Google Docs for Claude via gogcli — auth + full Docs and comments support",
   "author": {
     "name": "Chris Hall",
@@ -161,7 +161,7 @@
     },
     {
       "name": "gog_docs_append",
-      "description": "Append text to the end of a Google Doc (the right tool for iterative construction; sequential calls produce in-order content)"
+      "description": "Append text to the end of a Google Doc (the right tool for iterative construction). markdown=true known limitations (upstream): 3+ tables/call reorders trailing punctuation (split calls); inline bold/italic/code in cells renders literally (format after); empty-header tables leak literal pipes (use non-empty header)."
     },
     {
       "name": "gog_docs_read",
@@ -169,11 +169,27 @@
     },
     {
       "name": "gog_docs_format",
-      "description": "Apply text/paragraph formatting (bold, italic, font size, color, alignment, line spacing) — supports match, matchAll, matchCase"
+      "description": "Apply text/paragraph formatting (bold, italic, font size, color, alignment, line spacing, named style / heading level) — supports match, matchAll, matchCase"
     },
     {
       "name": "gog_docs_trash",
       "description": "Move an entire Google Doc to Drive trash (convenience wrapper around gog drive delete)"
+    },
+    {
+      "name": "gog_docs_comments_reopen",
+      "description": "Reopen a previously resolved comment."
+    },
+    {
+      "name": "gog_docs_insert_page_break",
+      "description": "Insert a Google Docs page break at a given index or at end-of-doc — the only path for multi-page deliverables."
+    },
+    {
+      "name": "gog_docs_page_layout",
+      "description": "Toggle page layout (pageless | pages) on an existing Google Doc."
+    },
+    {
+      "name": "gog_docs_insert_table",
+      "description": "Insert a native Google Docs table with given dimensions, optionally populated from a JSON 2D array."
     }
   ],
   "compatibility": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-docs",
-  "version": "2.0.10",
+  "version": "2.0.12",
   "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.0.10",
+  "version": "2.0.12",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp-docs",
-      "version": "2.0.10",
+      "version": "2.0.12",
       "transport": {
         "type": "stdio"
       },

package/src/tools/docs-extra.ts

@@ -105,6 +105,8 @@ export function registerExtraDocsTools(server: McpServer): void {
       noStrikethrough: z.boolean().optional().describe('Clear strikethrough'),
       alignment: z.enum(['left', 'center', 'right', 'justify', 'start', 'end', 'justified']).optional().describe('Paragraph alignment'),
       lineSpacing: z.number().optional().describe('Line spacing percentage (e.g. 100 for single, 150 for 1.5x, 200 for double)'),
+      headingLevel: z.number().int().optional().describe('Set paragraph named style to HEADING_1..HEADING_6 (shortcut for namedStyle=HEADING_N)'),
+      namedStyle: z.enum(['NORMAL_TEXT', 'TITLE', 'SUBTITLE', 'HEADING_1', 'HEADING_2', 'HEADING_3', 'HEADING_4', 'HEADING_5', 'HEADING_6']).optional().describe('Set paragraph named style explicitly'),
       account: accountParam,
     },
   }, async (args) => {
@@ -124,6 +126,8 @@ export function registerExtraDocsTools(server: McpServer): void {
       strikethrough?: boolean; noStrikethrough?: boolean;
       alignment?: string;
       lineSpacing?: number;
+      headingLevel?: number;
+      namedStyle?: string;
       account?: string;
     };
     const argv = ['docs', 'format', a.docId];
@@ -145,6 +149,8 @@ export function registerExtraDocsTools(server: McpServer): void {
     if (a.noStrikethrough) argv.push('--no-strikethrough');
     if (a.alignment) argv.push(`--alignment=${a.alignment}`);
     if (a.lineSpacing !== undefined) argv.push(`--line-spacing=${a.lineSpacing}`);
+    if (a.headingLevel !== undefined) argv.push(`--heading-level=${a.headingLevel}`);
+    if (a.namedStyle) argv.push(`--named-style=${a.namedStyle}`);
     return runOrDiagnose(argv, { account: a.account });
   });
 
@@ -185,13 +191,13 @@ export function registerExtraDocsTools(server: McpServer): void {
   });
 
   server.registerTool('gog_docs_append', {
-    description: 'Append text to the end of a Google Doc. This is the right tool for iterative document construction — multiple sequential calls produce content in the order they were called. Use gog_docs_insert only when you need to insert at a specific character position.',
+    description: 'Append text to the end of a Google Doc. This is the right tool for iterative document construction — multiple sequential calls produce content in the order they were called. Use gog_docs_insert only when you need to insert at a specific character position. Known markdown=true limitations (tracked upstream): (a) 3+ tables in one call reorders the trailing punctuation of the paragraph before the 3rd table — split into multiple calls with ≤2 tables each (openclaw/gogcli#607); (b) inline **bold** / *italic* / `code` inside table cells renders as literal characters — pre-format cell text separately or apply formatting after the append via gog_docs_format (openclaw/gogcli#608); (c) tables with an empty header row leak the last data row as literal pipe text — always supply a non-empty header (openclaw/gogcli#609).',
     annotations: { destructiveHint: true },
     inputSchema: {
       docId: z.string().describe('Doc ID (from the URL)'),
       text: z.string().optional().describe('Text content to append'),
       file: z.string().optional().describe('Path to a text file to append (use "-" for stdin)'),
-      markdown: z.boolean().optional().describe('Convert markdown to Google Docs formatting (headings, bold, lists, etc.)'),
+      markdown: z.boolean().optional().describe('Convert markdown to Google Docs formatting (headings, bold, lists, etc.). See the tool description for known upstream limitations around tables.'),
       tab: z.string().optional().describe('Target tab title or ID (for multi-tab docs)'),
       account: accountParam,
     },
@@ -342,4 +348,70 @@ export function registerExtraDocsTools(server: McpServer): void {
   }, async ({ docId, commentId, account }) => {
     return runOrDiagnose(['docs', 'comments', 'delete', docId, commentId], { account });
   });
+
+  server.registerTool('gog_docs_comments_reopen', {
+    description: 'Reopen a previously resolved comment (flip resolved → open).',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      commentId: z.string().describe('Comment ID to reopen'),
+      account: accountParam,
+    },
+  }, async ({ docId, commentId, account }) => {
+    return runOrDiagnose(['docs', 'comments', 'reopen', docId, commentId], { account });
+  });
+
+  server.registerTool('gog_docs_insert_page_break', {
+    description: 'Insert a Google Docs page break via InsertPageBreakRequest — the only path for multi-page deliverables (markdown has no page-break construct). Specify `index` for a precise character position, or `atEnd` for end-of-doc.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      index: z.number().int().optional().describe('Character index to insert at (1 = beginning). 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, index, atEnd, tab, account }) => {
+    const args = ['docs', 'insert-page-break', docId];
+    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_page_layout', {
+    description: 'Toggle the page layout (pageless | pages) of an existing Google Doc. Sibling to the --pageless flag on docs create/write/update for docs that were already created (e.g. by Drive markdown conversion) without the desired layout.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      layout: z.enum(['pageless', 'pages']).optional().describe('Page layout (default: pageless)'),
+      account: accountParam,
+    },
+  }, async ({ docId, layout, account }) => {
+    const args = ['docs', 'page-layout', docId];
+    if (layout) args.push(`--layout=${layout}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_insert_table', {
+    description: 'Insert a native Google Docs table via InsertTableRequest, bypassing the markdown writer. Use this instead of writing a markdown table when you need precise dimensions or to avoid the markdown writer\'s table limitations. `valuesJson` is a JSON 2D string array whose dimensions must match rows x cols.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      rows: z.number().int().min(1).describe('Number of rows (>=1)'),
+      cols: z.number().int().min(1).describe('Number of columns (>=1)'),
+      index: z.number().int().optional().describe('Character index to insert at (1 = beginning). Omit or use atEnd for end-of-doc.'),
+      atEnd: z.boolean().optional().describe('Insert at end-of-doc/tab (mutually exclusive with index)'),
+      valuesJson: z.string().optional().describe('Cell values as a JSON 2D string array; dimensions must match rows x cols when supplied'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, rows, cols, index, atEnd, valuesJson, tab, account }) => {
+    const args = ['docs', 'insert-table', docId, `--rows=${rows}`, `--cols=${cols}`];
+    if (index !== undefined) args.push(`--index=${index}`);
+    if (atEnd) args.push('--at-end');
+    if (valuesJson !== undefined) args.push(`--values-json=${valuesJson}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
 }

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

@@ -550,6 +550,28 @@ describe('gog_docs_append', () => {
       { account: undefined },
     );
   });
+
+  // Regression: the tool description must warn about the 3 known upstream
+  // markdown converter bugs (openclaw/gogcli#607, #608, #609). If upstream
+  // fixes any of these and the warning is removed, this test fails as a
+  // prompt to revisit + reopen the README/SKILL/TODO sections too.
+  it('description warns about all 3 known upstream markdown limitations', async () => {
+    // Local mock to capture the registration config (the shared harness only
+    // captures the handler callback).
+    const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+    const server = new McpServer({ name: 'test', version: '0.0.0' });
+    const configs = new Map<string, { description?: string }>();
+    vi.spyOn(server, 'registerTool').mockImplementation((name, config) => {
+      configs.set(name, config as { description?: string });
+      return undefined as never;
+    });
+    const { registerExtraDocsTools } = await import('../../src/tools/docs-extra.js');
+    registerExtraDocsTools(server);
+    const desc = configs.get('gog_docs_append')?.description ?? '';
+    expect(desc).toMatch(/openclaw\/gogcli#607/);
+    expect(desc).toMatch(/openclaw\/gogcli#608/);
+    expect(desc).toMatch(/openclaw\/gogcli#609/);
+  });
 });
 
 describe('gog_docs_read', () => {
@@ -643,4 +665,137 @@ describe('gog_docs_format', () => {
     await handlers.get('gog_docs_format')!({ docId: 'd1' });
     expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'format', 'd1'], { account: undefined });
   });
+
+  // gog 0.18.0
+  it('passes --heading-level and --named-style when provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_format')!({
+      docId: 'd1', match: 'Intro', headingLevel: 1, namedStyle: 'HEADING_1',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'format', 'd1', '--match=Intro', '--heading-level=1', '--named-style=HEADING_1'],
+      { account: undefined },
+    );
+  });
+
+  it('passes --heading-level=0 when explicitly 0 (HEADING_0 reserved but argument should reach gog)', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_format')!({ docId: 'd1', headingLevel: 0 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'format', 'd1', '--heading-level=0'],
+      { account: undefined },
+    );
+  });
+});
+
+// --- gog 0.18.0 new tools ---
+
+describe('gog_docs_insert_page_break', () => {
+  it('inserts at index when --index provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_page_break')!({ docId: 'd1', index: 42 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-page-break', 'd1', '--index=42'],
+      { account: undefined },
+    );
+  });
+
+  it('uses --at-end when atEnd is true', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_page_break')!({ docId: 'd1', atEnd: true, tab: 'Body' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-page-break', 'd1', '--at-end', '--tab=Body'],
+      { account: undefined },
+    );
+  });
+
+  it('passes --index=1 when explicitly 1', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_page_break')!({ docId: 'd1', index: 1 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-page-break', 'd1', '--index=1'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_page_layout', () => {
+  it('passes --layout when provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_page_layout')!({ docId: 'd1', layout: 'pages' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'page-layout', 'd1', '--layout=pages'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --layout when not provided (defaults to pageless on gog side)', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_page_layout')!({ docId: 'd1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'page-layout', 'd1'], { account: undefined });
+  });
+});
+
+describe('gog_docs_insert_table', () => {
+  it('passes required --rows and --cols', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_table')!({ docId: 'd1', rows: 3, cols: 2 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-table', 'd1', '--rows=3', '--cols=2'],
+      { account: undefined },
+    );
+  });
+
+  it('passes --values-json, --index, --tab when provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    const vj = '[["a","b"],["c","d"]]';
+    await handlers.get('gog_docs_insert_table')!({
+      docId: 'd1', rows: 2, cols: 2, index: 10, valuesJson: vj, tab: 'Body',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-table', 'd1', '--rows=2', '--cols=2', '--index=10', `--values-json=${vj}`, '--tab=Body'],
+      { account: undefined },
+    );
+  });
+
+  it('uses --at-end when atEnd is true', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_table')!({ docId: 'd1', rows: 1, cols: 1, atEnd: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-table', 'd1', '--rows=1', '--cols=1', '--at-end'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_comments_reopen', () => {
+  it('calls runOrDiagnose with docId and commentId', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_comments_reopen')!({ docId: 'd1', commentId: 'c1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'comments', 'reopen', 'd1', 'c1'],
+      { account: undefined },
+    );
+  });
+
+  it('forwards account', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_comments_reopen')!({ docId: 'd1', commentId: 'c1', account: 'a@b.com' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'comments', 'reopen', 'd1', 'c1'],
+      { account: 'a@b.com' },
+    );
+  });
 });