gogcli-mcp-docs 2.0.10 → 2.0.11

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.11"
   },
   "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.11",
       "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.11",
   "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.11" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31459,13 +31459,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
     }

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.11",
   "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",

package/package.json

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

package/src/tools/docs-extra.ts

@@ -185,13 +185,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,
     },

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', () => {