gogcli-mcp-docs 2.6.1 → 2.7.1

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

package/.claude-plugin/plugin.json

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

package/LICENSE

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

package/dist/index.js

@@ -31276,11 +31276,13 @@ function registerDocsTools(server2) {
       docId: external_exports.string().describe("Doc ID (from the URL)"),
       text: external_exports.string().describe("Text content to write"),
       append: external_exports.boolean().optional().describe("Append to existing content instead of replacing (default: false)"),
+      checkOrphans: external_exports.boolean().optional().describe("Block the write (exit code 11) if it would orphan an open comment \u2014 i.e. remove the text the comment is anchored to. Recommended for replacement writes on commented docs."),
       account: accountParam
     }
-  }, async ({ docId, text, append, account }) => {
+  }, async ({ docId, text, append, checkOrphans, account }) => {
     const args = ["docs", "write", docId, `--text=${text}`];
     if (append) args.push("--append");
+    if (checkOrphans) args.push("--check-orphans");
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_docs_find_replace", {
@@ -31318,7 +31320,7 @@ var failIfNotEmptyParam = external_exports.boolean().optional().describe(
 );
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.6.1" : "0.0.0";
+var VERSION = true ? "2.7.1" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31396,14 +31398,17 @@ function registerExtraDocsTools(server2) {
     inputSchema: {
       docId: external_exports.string().describe("Doc ID (from the URL)"),
       format: external_exports.enum(["text", "json"]).optional().describe("Output format (default: text)"),
-      tab: external_exports.string().optional().describe("Target tab title or ID (text mode only)"),
-      allTabs: external_exports.boolean().optional().describe("Show all tabs with headers (text mode only)"),
+      tab: external_exports.string().optional().describe("Target tab title or ID. In json mode, returns that one tab in the legacy top-level Document shape."),
+      allTabs: external_exports.boolean().optional().describe("Show all tabs. In json mode, returns the canonical Document response with all tab content populated."),
       maxBytes: external_exports.number().optional().describe("Max bytes to read in text mode (0 = unlimited; default 2000000)"),
       account: accountParam
     }
   }, async ({ docId, format, tab, allTabs, maxBytes, account }) => {
     if (format === "json") {
-      return runOrDiagnose(["docs", "raw", docId, "--pretty"], { account });
+      const args2 = ["docs", "raw", docId, "--pretty"];
+      if (tab) args2.push(`--tab=${tab}`);
+      if (allTabs) args2.push("--all-tabs");
+      return runOrDiagnose(args2, { account });
     }
     const args = ["docs", "cat", docId];
     if (tab) args.push(`--tab=${tab}`);
@@ -31743,6 +31748,230 @@ function registerExtraDocsTools(server2) {
     if (tab) args.push(`--tab=${tab}`);
     return runOrDiagnose(args, { account });
   });
+  const tableSelectorParam = external_exports.string().optional().describe("Table selector: 1-based index (negative from the end), exact first-cell text, * for the only table, or text:VALUE for numeric/syntax-looking first-cell text (default: 1)");
+  server2.registerTool("gog_docs_table_row_insert", {
+    description: 'Insert a row into a native Google Docs table, optionally populated from a JSON string array. Inserts before the 1-based position given by `at` (negative counts from the end; "end" appends \u2014 the default).',
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      table: tableSelectorParam,
+      at: external_exports.string().optional().describe('Insert before this 1-based row, a negative index from the end, or "end" to append (default: end)'),
+      valuesJson: external_exports.string().optional().describe(`JSON string array with the new row's cell values, e.g. ["Name","Qty"]`),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, table, at, valuesJson, tab, account }) => {
+    const args = ["docs", "table-row", "insert", docId];
+    if (table) args.push(`--table=${table}`);
+    if (at) args.push(`--at=${at}`);
+    if (valuesJson) args.push(`--values-json=${valuesJson}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_table_row_delete", {
+    description: "Delete a row from a native Google Docs table by 1-based row number (negative counts from the end). The row's cell content is lost.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      row: external_exports.number().int().describe("1-based row number; negative indexes count from the end"),
+      table: tableSelectorParam,
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, row, table, tab, account }) => {
+    const args = ["docs", "table-row", "delete", docId, `--row=${row}`];
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_table_column_insert", {
+    description: 'Insert a column into a native Google Docs table. Inserts before the 1-based position given by `at` (negative counts from the end; "end" appends \u2014 the default).',
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      table: tableSelectorParam,
+      at: external_exports.string().optional().describe('Insert before this 1-based column, a negative index from the end, or "end" to append (default: end)'),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, table, at, tab, account }) => {
+    const args = ["docs", "table-column", "insert", docId];
+    if (at) args.push(`--at=${at}`);
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_table_column_delete", {
+    description: "Delete a column from a native Google Docs table by 1-based column number (negative counts from the end). The column's cell content is lost.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      col: external_exports.number().int().describe("1-based column number; negative indexes count from the end"),
+      table: tableSelectorParam,
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, col, table, tab, account }) => {
+    const args = ["docs", "table-column", "delete", docId, `--col=${col}`];
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_table_merge", {
+    description: "Merge a rectangular cell range in a native Google Docs table. Content of non-first cells in the range is absorbed/discarded by the merge \u2014 use gog_docs_table_unmerge to split back.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      range: external_exports.string().describe('1-based cell range r1,c1:r2,c2 (e.g. "1,1:2,3")'),
+      table: tableSelectorParam,
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, range, table, tab, account }) => {
+    const args = ["docs", "table-merge", docId, `--range=${range}`];
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_table_unmerge", {
+    description: "Unmerge (split) the merged region containing a given cell in a native Google Docs table.",
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      cell: external_exports.string().describe('1-based cell r,c inside the merged region (e.g. "1,1")'),
+      table: tableSelectorParam,
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, cell, table, tab, account }) => {
+    const args = ["docs", "table-unmerge", docId, `--cell=${cell}`];
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_named_range_create", {
+    description: "Create a named range \u2014 a durable, tab-aware anchor over a span of document text that survives subsequent edits (unlike raw indices). Anchor by literal text (`at`) or explicit UTF-16 start/end indices. Pair with gog_docs_named_range_replace for repeatable templated updates.",
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      name: external_exports.string().describe("Unique named range name"),
+      at: external_exports.string().optional().describe("Create the range around this literal matched text, instead of start/end indices"),
+      occurrence: external_exports.number().int().optional().describe("Use the Nth `at` match (1-based; required when `at` is ambiguous)"),
+      matchCase: external_exports.boolean().optional().describe("Case-sensitive `at` matching"),
+      start: external_exports.number().int().optional().describe("Range start UTF-16 index (inclusive). Required with end unless `at` is set."),
+      end: external_exports.number().int().optional().describe("Range end UTF-16 index (exclusive). Required with start unless `at` is set."),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, name, at, occurrence, matchCase, start, end, tab, account }) => {
+    const args = ["docs", "named-range", "create", docId, `--name=${name}`];
+    if (at) args.push(`--at=${at}`);
+    if (occurrence !== void 0) args.push(`--occurrence=${occurrence}`);
+    if (matchCase) args.push("--match-case");
+    if (start !== void 0) args.push(`--start=${start}`);
+    if (end !== void 0) args.push(`--end=${end}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_named_range_list", {
+    description: "List named ranges in a Google Doc, optionally filtered by name.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      name: external_exports.string().optional().describe("Only return ranges with this name"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, name, tab, account }) => {
+    const args = ["docs", "named-range", "list", docId];
+    if (name) args.push(`--name=${name}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_named_range_delete", {
+    description: "Delete a named range (the anchor only \u2014 the underlying document text is untouched).",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      nameOrId: external_exports.string().describe("Named range name or ID"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, nameOrId, tab, account }) => {
+    const args = ["docs", "named-range", "delete", docId, nameOrId];
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_named_range_replace", {
+    description: "Replace the text inside a named range with new content (inline or from a file), keeping the anchor for future updates \u2014 the templated-update workhorse.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      nameOrId: external_exports.string().describe("Named range name or ID"),
+      text: external_exports.string().optional().describe("Replacement text"),
+      file: external_exports.string().optional().describe("Path to a file with the replacement text"),
+      tab: external_exports.string().optional().describe("Target a specific tab by title or ID"),
+      account: accountParam
+    }
+  }, async ({ docId, nameOrId, text, file: file2, tab, account }) => {
+    const args = ["docs", "named-range", "replace", docId, nameOrId];
+    if (text !== void 0) args.push(`--text=${text}`);
+    if (file2) args.push(`--file=${file2}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_tables_list", {
+    description: "Enumerate the native tables in a Google Doc (dimensions, position) \u2014 the index/first-cell-text it reports feeds the `table` selector on the table-row/column/merge tools.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      tab: external_exports.string().optional().describe("Tab title or ID (omit for default)"),
+      account: accountParam
+    }
+  }, async ({ docId, tab, account }) => {
+    const args = ["docs", "tables", "list", docId];
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_images_list", {
+    description: "Enumerate inline/positioned images in a Google Doc.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      tab: external_exports.string().optional().describe("Tab title or ID (omit for default)"),
+      account: accountParam
+    }
+  }, async ({ docId, tab, account }) => {
+    const args = ["docs", "images", "list", docId];
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_headings_list", {
+    description: "Enumerate headings in a Google Doc (a lightweight outline view), optionally filtered to one heading level.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      level: external_exports.number().int().optional().describe("Only return this heading level (1-6)"),
+      tab: external_exports.string().optional().describe("Tab title or ID (omit for default)"),
+      account: accountParam
+    }
+  }, async ({ docId, level, tab, account }) => {
+    const args = ["docs", "headings", "list", docId];
+    if (level !== void 0) args.push(`--level=${level}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_docs_paragraphs_list", {
+    description: "Enumerate paragraphs in a Google Doc with emptiness, text-run ranges, styles, and links \u2014 richer than gog_docs_structure when you need per-run detail. Optionally filter to one named style.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: external_exports.string().describe("Doc ID (from the URL)"),
+      style: external_exports.string().optional().describe("Only return this named style (e.g. NORMAL_TEXT or HEADING_2)"),
+      tab: external_exports.string().optional().describe("Tab title or ID (omit for default)"),
+      account: accountParam
+    }
+  }, async ({ docId, style, tab, account }) => {
+    const args = ["docs", "paragraphs", "list", docId];
+    if (style) args.push(`--style=${style}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { 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 },
@@ -31871,11 +32100,12 @@ function registerExtraDocsTools(server2) {
     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.",
+    description: "Insert an image into a Google Doc from a local file or a public HTTPS URL. file: uploaded to Drive, temporarily shared so Docs can fetch it, inserted, then the public permission is revoked. url: inserted directly with no Drive upload or temporary sharing. 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"),
+      file: external_exports.string().optional().describe("Local PNG, JPEG, or GIF image to upload and insert (exactly one of file or url)"),
+      url: external_exports.string().optional().describe("Public HTTPS image URL to insert directly \u2014 no Drive upload or temporary public sharing (exactly one of file or url)"),
       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)"),
@@ -31885,8 +32115,10 @@ function registerExtraDocsTools(server2) {
       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}`];
+  }, async ({ docId, file: file2, url: url2, at, width, height, name, parent, onRestricted, tab, account }) => {
+    const args = ["docs", "insert-image", docId];
+    if (file2) args.push(`--file=${file2}`);
+    if (url2) args.push(`--url=${url2}`);
     if (at) args.push(`--at=${at}`);
     if (width !== void 0) args.push(`--width=${width}`);
     if (height !== void 0) args.push(`--height=${height}`);

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-docs",
   "display_name": "gogcli (Docs)",
-  "version": "2.6.1",
+  "version": "2.7.1",
   "description": "Extended Google Docs for Claude via gogcli — auth + full Docs and comments support",
   "author": {
     "name": "Chris Hall",
@@ -207,6 +207,62 @@
       "name": "gog_docs_table_column_width",
       "description": "Set a fixed table column width in points, or reset columns to Docs-managed even distribution."
     },
+    {
+      "name": "gog_docs_table_row_insert",
+      "description": "Insert a table row, optionally populated from a JSON string array."
+    },
+    {
+      "name": "gog_docs_table_row_delete",
+      "description": "Delete a table row by 1-based number."
+    },
+    {
+      "name": "gog_docs_table_column_insert",
+      "description": "Insert a table column before a 1-based position or at the end."
+    },
+    {
+      "name": "gog_docs_table_column_delete",
+      "description": "Delete a table column by 1-based number."
+    },
+    {
+      "name": "gog_docs_table_merge",
+      "description": "Merge a rectangular cell range in a table."
+    },
+    {
+      "name": "gog_docs_table_unmerge",
+      "description": "Unmerge (split) the merged region containing a cell."
+    },
+    {
+      "name": "gog_docs_named_range_create",
+      "description": "Create a named range — a durable anchor over document text, by matched text or indices."
+    },
+    {
+      "name": "gog_docs_named_range_list",
+      "description": "List named ranges, optionally filtered by name."
+    },
+    {
+      "name": "gog_docs_named_range_delete",
+      "description": "Delete a named range anchor (the text is untouched)."
+    },
+    {
+      "name": "gog_docs_named_range_replace",
+      "description": "Replace the text inside a named range, keeping the anchor for future updates."
+    },
+    {
+      "name": "gog_docs_tables_list",
+      "description": "Enumerate native tables (dimensions, position) — feeds the table selector on the table tools."
+    },
+    {
+      "name": "gog_docs_images_list",
+      "description": "Enumerate inline/positioned images."
+    },
+    {
+      "name": "gog_docs_headings_list",
+      "description": "Enumerate headings (outline view), optionally one level."
+    },
+    {
+      "name": "gog_docs_paragraphs_list",
+      "description": "Enumerate paragraphs with text-run ranges, styles, and links."
+    },
     {
       "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."

package/package.json

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

package/src/tools/docs-extra.ts

@@ -75,14 +75,17 @@ export function registerExtraDocsTools(server: McpServer): void {
     inputSchema: {
       docId: z.string().describe('Doc ID (from the URL)'),
       format: z.enum(['text', 'json']).optional().describe('Output format (default: text)'),
-      tab: z.string().optional().describe('Target tab title or ID (text mode only)'),
-      allTabs: z.boolean().optional().describe('Show all tabs with headers (text mode only)'),
+      tab: z.string().optional().describe('Target tab title or ID. In json mode, returns that one tab in the legacy top-level Document shape.'),
+      allTabs: z.boolean().optional().describe('Show all tabs. In json mode, returns the canonical Document response with all tab content populated.'),
       maxBytes: z.number().optional().describe('Max bytes to read in text mode (0 = unlimited; default 2000000)'),
       account: accountParam,
     },
   }, async ({ docId, format, tab, allTabs, maxBytes, account }) => {
     if (format === 'json') {
-      return runOrDiagnose(['docs', 'raw', docId, '--pretty'], { account });
+      const args = ['docs', 'raw', docId, '--pretty'];
+      if (tab) args.push(`--tab=${tab}`);
+      if (allTabs) args.push('--all-tabs');
+      return runOrDiagnose(args, { account });
     }
     const args = ['docs', 'cat', docId];
     if (tab) args.push(`--tab=${tab}`);
@@ -464,6 +467,247 @@ export function registerExtraDocsTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  // Shared describe for the --table selector used by the table-row/column/merge
+  // tools (a richer addressing scheme than the older tableIndex param).
+  const tableSelectorParam = z.string().optional().describe('Table selector: 1-based index (negative from the end), exact first-cell text, * for the only table, or text:VALUE for numeric/syntax-looking first-cell text (default: 1)');
+
+  server.registerTool('gog_docs_table_row_insert', {
+    description: 'Insert a row into a native Google Docs table, optionally populated from a JSON string array. Inserts before the 1-based position given by `at` (negative counts from the end; "end" appends — the default).',
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      table: tableSelectorParam,
+      at: z.string().optional().describe('Insert before this 1-based row, a negative index from the end, or "end" to append (default: end)'),
+      valuesJson: z.string().optional().describe('JSON string array with the new row\'s cell values, e.g. ["Name","Qty"]'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, table, at, valuesJson, tab, account }) => {
+    const args = ['docs', 'table-row', 'insert', docId];
+    if (table) args.push(`--table=${table}`);
+    if (at) args.push(`--at=${at}`);
+    if (valuesJson) args.push(`--values-json=${valuesJson}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_table_row_delete', {
+    description: 'Delete a row from a native Google Docs table by 1-based row number (negative counts from the end). The row\'s cell content is lost.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      row: z.number().int().describe('1-based row number; negative indexes count from the end'),
+      table: tableSelectorParam,
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, row, table, tab, account }) => {
+    const args = ['docs', 'table-row', 'delete', docId, `--row=${row}`];
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_table_column_insert', {
+    description: 'Insert a column into a native Google Docs table. Inserts before the 1-based position given by `at` (negative counts from the end; "end" appends — the default).',
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      table: tableSelectorParam,
+      at: z.string().optional().describe('Insert before this 1-based column, a negative index from the end, or "end" to append (default: end)'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, table, at, tab, account }) => {
+    const args = ['docs', 'table-column', 'insert', docId];
+    if (at) args.push(`--at=${at}`);
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_table_column_delete', {
+    description: 'Delete a column from a native Google Docs table by 1-based column number (negative counts from the end). The column\'s cell content is lost.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      col: z.number().int().describe('1-based column number; negative indexes count from the end'),
+      table: tableSelectorParam,
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, col, table, tab, account }) => {
+    const args = ['docs', 'table-column', 'delete', docId, `--col=${col}`];
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_table_merge', {
+    description: 'Merge a rectangular cell range in a native Google Docs table. Content of non-first cells in the range is absorbed/discarded by the merge — use gog_docs_table_unmerge to split back.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      range: z.string().describe('1-based cell range r1,c1:r2,c2 (e.g. "1,1:2,3")'),
+      table: tableSelectorParam,
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, range, table, tab, account }) => {
+    const args = ['docs', 'table-merge', docId, `--range=${range}`];
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_table_unmerge', {
+    description: 'Unmerge (split) the merged region containing a given cell in a native Google Docs table.',
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      cell: z.string().describe('1-based cell r,c inside the merged region (e.g. "1,1")'),
+      table: tableSelectorParam,
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, cell, table, tab, account }) => {
+    const args = ['docs', 'table-unmerge', docId, `--cell=${cell}`];
+    if (table) args.push(`--table=${table}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_named_range_create', {
+    description: 'Create a named range — a durable, tab-aware anchor over a span of document text that survives subsequent edits (unlike raw indices). Anchor by literal text (`at`) or explicit UTF-16 start/end indices. Pair with gog_docs_named_range_replace for repeatable templated updates.',
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      name: z.string().describe('Unique named range name'),
+      at: z.string().optional().describe('Create the range around this literal matched text, instead of start/end indices'),
+      occurrence: z.number().int().optional().describe('Use the Nth `at` match (1-based; required when `at` is ambiguous)'),
+      matchCase: z.boolean().optional().describe('Case-sensitive `at` matching'),
+      start: z.number().int().optional().describe('Range start UTF-16 index (inclusive). Required with end unless `at` is set.'),
+      end: z.number().int().optional().describe('Range end UTF-16 index (exclusive). Required with start unless `at` is set.'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, name, at, occurrence, matchCase, start, end, tab, account }) => {
+    const args = ['docs', 'named-range', 'create', docId, `--name=${name}`];
+    if (at) args.push(`--at=${at}`);
+    if (occurrence !== undefined) args.push(`--occurrence=${occurrence}`);
+    if (matchCase) args.push('--match-case');
+    if (start !== undefined) args.push(`--start=${start}`);
+    if (end !== undefined) args.push(`--end=${end}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_named_range_list', {
+    description: 'List named ranges in a Google Doc, optionally filtered by name.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      name: z.string().optional().describe('Only return ranges with this name'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, name, tab, account }) => {
+    const args = ['docs', 'named-range', 'list', docId];
+    if (name) args.push(`--name=${name}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_named_range_delete', {
+    description: 'Delete a named range (the anchor only — the underlying document text is untouched).',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      nameOrId: z.string().describe('Named range name or ID'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, nameOrId, tab, account }) => {
+    const args = ['docs', 'named-range', 'delete', docId, nameOrId];
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_named_range_replace', {
+    description: 'Replace the text inside a named range with new content (inline or from a file), keeping the anchor for future updates — the templated-update workhorse.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      nameOrId: z.string().describe('Named range name or ID'),
+      text: z.string().optional().describe('Replacement text'),
+      file: z.string().optional().describe('Path to a file with the replacement text'),
+      tab: z.string().optional().describe('Target a specific tab by title or ID'),
+      account: accountParam,
+    },
+  }, async ({ docId, nameOrId, text, file, tab, account }) => {
+    const args = ['docs', 'named-range', 'replace', docId, nameOrId];
+    if (text !== undefined) args.push(`--text=${text}`);
+    if (file) args.push(`--file=${file}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_tables_list', {
+    description: 'Enumerate the native tables in a Google Doc (dimensions, position) — the index/first-cell-text it reports feeds the `table` selector on the table-row/column/merge tools.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      tab: z.string().optional().describe('Tab title or ID (omit for default)'),
+      account: accountParam,
+    },
+  }, async ({ docId, tab, account }) => {
+    const args = ['docs', 'tables', 'list', docId];
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_images_list', {
+    description: 'Enumerate inline/positioned images in a Google Doc.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      tab: z.string().optional().describe('Tab title or ID (omit for default)'),
+      account: accountParam,
+    },
+  }, async ({ docId, tab, account }) => {
+    const args = ['docs', 'images', 'list', docId];
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_headings_list', {
+    description: 'Enumerate headings in a Google Doc (a lightweight outline view), optionally filtered to one heading level.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      level: z.number().int().optional().describe('Only return this heading level (1-6)'),
+      tab: z.string().optional().describe('Tab title or ID (omit for default)'),
+      account: accountParam,
+    },
+  }, async ({ docId, level, tab, account }) => {
+    const args = ['docs', 'headings', 'list', docId];
+    if (level !== undefined) args.push(`--level=${level}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_paragraphs_list', {
+    description: 'Enumerate paragraphs in a Google Doc with emptiness, text-run ranges, styles, and links — richer than gog_docs_structure when you need per-run detail. Optionally filter to one named style.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      style: z.string().optional().describe('Only return this named style (e.g. NORMAL_TEXT or HEADING_2)'),
+      tab: z.string().optional().describe('Tab title or ID (omit for default)'),
+      account: accountParam,
+    },
+  }, async ({ docId, style, tab, account }) => {
+    const args = ['docs', 'paragraphs', 'list', docId];
+    if (style) args.push(`--style=${style}`);
+    if (tab) args.push(`--tab=${tab}`);
+    return runOrDiagnose(args, { 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 },
@@ -597,11 +841,12 @@ export function registerExtraDocsTools(server: McpServer): void {
   });
 
   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.',
+    description: 'Insert an image into a Google Doc from a local file or a public HTTPS URL. file: uploaded to Drive, temporarily shared so Docs can fetch it, inserted, then the public permission is revoked. url: inserted directly with no Drive upload or temporary sharing. 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'),
+      file: z.string().optional().describe('Local PNG, JPEG, or GIF image to upload and insert (exactly one of file or url)'),
+      url: z.string().optional().describe('Public HTTPS image URL to insert directly — no Drive upload or temporary public sharing (exactly one of file or url)'),
       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)'),
@@ -611,8 +856,10 @@ export function registerExtraDocsTools(server: McpServer): void {
       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}`];
+  }, async ({ docId, file, url, at, width, height, name, parent, onRestricted, tab, account }) => {
+    const args = ['docs', 'insert-image', docId];
+    if (file) args.push(`--file=${file}`);
+    if (url) args.push(`--url=${url}`);
     if (at) args.push(`--at=${at}`);
     if (width !== undefined) args.push(`--width=${width}`);
     if (height !== undefined) args.push(`--height=${height}`);

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

@@ -1262,3 +1262,223 @@ describe('gog_docs_clear', () => {
     expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'clear', 'abc'], { account: 'a@b.com' });
   });
 });
+
+// --- gog 0.24.0 ---
+
+describe('gog_docs_table_row_insert', () => {
+  it('appends a row with values to a selected table', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_table_row_insert')!({
+      docId: 'd1', table: '2', at: 'end', valuesJson: '["A","B"]', tab: 'T',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'table-row', 'insert', 'd1', '--table=2', '--at=end', '--values-json=["A","B"]', '--tab=T'],
+      { account: undefined },
+    );
+  });
+
+  it('works with no optional flags', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_table_row_insert')!({ docId: 'd1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'table-row', 'insert', 'd1'], { account: undefined });
+  });
+});
+
+describe('gog_docs_table_row_delete', () => {
+  it('deletes a row by 1-based number', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_table_row_delete')!({ docId: 'd1', row: -1, table: 'Budget' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'table-row', 'delete', 'd1', '--row=-1', '--table=Budget'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_table_column_insert', () => {
+  it('inserts a column before a 1-based index', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_table_column_insert')!({ docId: 'd1', at: '3', table: '*', tab: 'T' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'table-column', 'insert', 'd1', '--at=3', '--table=*', '--tab=T'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_table_column_delete', () => {
+  it('deletes a column by 1-based number', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_table_column_delete')!({ docId: 'd1', col: 2 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'table-column', 'delete', 'd1', '--col=2'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_table_merge', () => {
+  it('merges a 1-based cell range', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_table_merge')!({ docId: 'd1', range: '1,1:2,3', table: '1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'table-merge', 'd1', '--range=1,1:2,3', '--table=1'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_table_unmerge', () => {
+  it('unmerges the region containing a cell', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_table_unmerge')!({ docId: 'd1', cell: '1,1', tab: 'T' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'table-unmerge', 'd1', '--cell=1,1', '--tab=T'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_named_range_create', () => {
+  it('creates a range around matched text', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_named_range_create')!({
+      docId: 'd1', name: 'intro', at: 'Introduction', occurrence: 1, matchCase: true,
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'named-range', 'create', 'd1', '--name=intro', '--at=Introduction', '--occurrence=1', '--match-case'],
+      { account: undefined },
+    );
+  });
+
+  it('creates a range from explicit indices', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_named_range_create')!({ docId: 'd1', name: 'intro', start: 5, end: 20, tab: 'T' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'named-range', 'create', 'd1', '--name=intro', '--start=5', '--end=20', '--tab=T'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_named_range_list', () => {
+  it('lists named ranges, optionally filtered by name', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_named_range_list')!({ docId: 'd1', name: 'intro' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'named-range', 'list', 'd1', '--name=intro'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_named_range_delete', () => {
+  it('deletes by name or id', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_named_range_delete')!({ docId: 'd1', nameOrId: 'intro' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'named-range', 'delete', 'd1', 'intro'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_named_range_replace', () => {
+  it('replaces range content with text', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_named_range_replace')!({ docId: 'd1', nameOrId: 'intro', text: 'New intro', tab: 'T' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'named-range', 'replace', 'd1', 'intro', '--text=New intro', '--tab=T'],
+      { account: undefined },
+    );
+  });
+
+  it('replaces range content from a file', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_named_range_replace')!({ docId: 'd1', nameOrId: 'kix.abc', file: '/tmp/intro.txt' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'named-range', 'replace', 'd1', 'kix.abc', '--file=/tmp/intro.txt'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_tables_list', () => {
+  it('enumerates tables, tab-aware', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_tables_list')!({ docId: 'd1', tab: 'T' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'tables', 'list', 'd1', '--tab=T'], { account: undefined });
+  });
+});
+
+describe('gog_docs_images_list', () => {
+  it('enumerates images', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_images_list')!({ docId: 'd1' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'images', 'list', 'd1'], { account: undefined });
+  });
+});
+
+describe('gog_docs_headings_list', () => {
+  it('enumerates headings with a level filter', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_headings_list')!({ docId: 'd1', level: 2 });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'headings', 'list', 'd1', '--level=2'], { account: undefined });
+  });
+});
+
+describe('gog_docs_paragraphs_list', () => {
+  it('enumerates paragraphs with a style filter', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_paragraphs_list')!({ docId: 'd1', style: 'HEADING_2', tab: 'T' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'paragraphs', 'list', 'd1', '--style=HEADING_2', '--tab=T'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_insert_image url mode', () => {
+  it('inserts a public HTTPS image by url without file', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_insert_image')!({ docId: 'd1', url: 'https://x.test/i.png', at: '{{logo}}' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['docs', 'insert-image', 'd1', '--url=https://x.test/i.png', '--at={{logo}}'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_docs_read json tab targeting', () => {
+  it('passes --tab through to docs raw in json mode', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_read')!({ docId: 'd1', format: 'json', tab: 'T' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'raw', 'd1', '--pretty', '--tab=T'], { account: undefined });
+  });
+
+  it('passes --all-tabs through to docs raw in json mode', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_docs_read')!({ docId: 'd1', format: 'json', allTabs: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['docs', 'raw', 'd1', '--pretty', '--all-tabs'], { account: undefined });
+  });
+});