gogcli-mcp 2.27.1 → 2.28.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-    "version": "2.27.1"
+    "version": "2.28.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli",
       "source": "./",
       "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-      "version": "2.27.1",
+      "version": "2.28.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp",
   "displayName": "gogcli",
-  "version": "2.27.1",
+  "version": "2.28.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/README.md

@@ -3,7 +3,7 @@
 > [!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.
 
-Base [Model Context Protocol](https://modelcontextprotocol.io) server that gives Claude access to Google Workspace via [gogcli](https://github.com/openclaw/gogcli). Includes 114 tools across 13 services: Sheets, Docs, Gmail, Calendar, Drive, Slides, Classroom, Chat, Apps Script, Tasks, Contacts, the generic Discovery API escape hatch, and Auth.
+Base [Model Context Protocol](https://modelcontextprotocol.io) server that gives Claude access to Google Workspace via [gogcli](https://github.com/openclaw/gogcli). Includes 115 tools across 13 services: Sheets, Docs, Gmail, Calendar, Drive, Slides, Classroom, Chat, Apps Script, Tasks, Contacts, the generic Discovery API escape hatch, and Auth.
 
 For extended Sheets or Docs support, see [gogcli-mcp-sheets](https://www.npmjs.com/package/gogcli-mcp-sheets) and [gogcli-mcp-docs](https://www.npmjs.com/package/gogcli-mcp-docs).
 
@@ -46,7 +46,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 claude mcp add gogcli-mcp -- gogcli-mcp
 ```
 
-## Tools (114)
+## Tools (115)
 
 | Service | Tools | Includes |
 |---------|-------|----------|
@@ -57,7 +57,7 @@ claude mcp add gogcli-mcp -- gogcli-mcp
 | **Drive** | 11 | ls, search, get, mkdir, rename, move, delete, share, extract-text, read-bytes, run |
 | **Slides** | 7 | export, info, create, copy, list-slides, read-slide, run |
 | **Classroom** | 25 | courses, students, teachers, roster, coursework, submissions (grade/return/turn-in/reclaim), announcements, topics, invitations, profile, run |
-| **Chat** | 12 | spaces list/find/create, threads list, messages list/send, dm send/space, reactions list/create/delete, run |
+| **Chat** | 13 | spaces list/find/create, threads list, messages list/search/send, dm send/space, reactions list/create/delete, run |
 | **Apps Script** | 8 | get, content, pull, create, deployments, versions, run-function, run |
 | **Tasks** | 7 | lists, list, get, add, done, delete, run |
 | **Contacts** | 5 | search, list, get, create, run |

package/SKILL.md

@@ -32,7 +32,7 @@ MCP server wrapping [gogcli](https://github.com/openclaw/gogcli) — provides Cl
 
 `GOG_ACCOUNT` is optional — omit it to use gogcli's configured default account.
 
-## Tools (114)
+## Tools (115)
 
 | Service | Tools |
 |---------|-------|
@@ -43,7 +43,7 @@ MCP server wrapping [gogcli](https://github.com/openclaw/gogcli) — provides Cl
 | **Drive** (11) | ls, search, get, mkdir, rename, move, delete, share, extract-text, read-bytes, run |
 | **Slides** (7) | export, info, create, copy, list-slides, read-slide, run |
 | **Classroom** (25) | courses, students, teachers, roster, coursework, submissions (grade/return/turn-in/reclaim), announcements, topics, invitations, profile, run |
-| **Chat** (12) | spaces list/find/create, threads list, messages list/send, dm send/space, reactions list/create/delete, run |
+| **Chat** (13) | spaces list/find/create, threads list, messages list/search/send, dm send/space, reactions list/create/delete, run |
 | **Apps Script** (8) | get, content, pull, create, deployments, versions, run-function, run |
 | **Tasks** (7) | lists, list, get, add, done, delete, run |
 | **Contacts** (5) | search, list, get, create, run |

package/dist/index.js

@@ -32755,6 +32755,30 @@ function registerChatTools(server) {
     pushPaginationFlags(args, { max, pageToken, page, all });
     return runOrDiagnose(args, { account });
   });
+  server.registerTool("gog_chat_messages_search", {
+    description: 'Search Chat messages ACROSS every space and DM the account can see (gog >= 0.39.0) \u2014 the tool to reach for when the user asks "where did we discuss X" without naming a room, since gog_chat_messages_list needs a space up front. The query is Google Chat filter syntax, so it takes plain keywords or filters like sender, space, date, mention, unread, link and attachment. It is a search, NOT an export: Chat excludes some conversations (muted spaces among them), so an empty result does not prove a message never existed. view="full" adds each hit\'s read state and space mute setting; read state works on an ordinary chat grant, but the mute setting needs chat.users.spacesettings, which gog\'s chat scope set does NOT request (re-auth with extraScopes to get it). Missing metadata is OMITTED rather than defaulted, so an absent `read` means unknown while an explicit false means unread.' + workspaceOnlyNote,
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: external_exports.string().describe('Google Chat filter-syntax query \u2014 keywords, or filters such as "from:alice@example.com budget"'),
+      order: external_exports.enum(["create_time desc", "relevance desc"]).optional().describe(
+        `Sort order. NOTE the snake_case, which differs from gog_chat_messages_list's camelCase. "relevance desc" needs Google Developer Preview access and errors without it`
+      ),
+      view: external_exports.enum(["basic", "full"]).optional().describe(
+        'Result view (default "basic"). "full" also requests read state (covered by an ordinary chat grant) and space mute setting (needs chat.users.spacesettings, which that grant does not include)'
+      ),
+      markup: external_exports.enum(["chat", "markdown"]).optional().describe("Syntax to render each hit's formatted text in"),
+      ...paginationParams,
+      max: external_exports.number().int().min(1).max(100).optional().describe("Max results per page (1-100; Chat search caps a page at 100)"),
+      account: accountParam
+    }
+  }, async ({ query, order, view, markup, max, pageToken, page, all, account }) => {
+    const args = ["chat", "messages", "search", query];
+    if (order) args.push(`--order=${order}`);
+    if (view) args.push(`--view=${view}`);
+    if (markup) args.push(`--markup=${markup}`);
+    pushPaginationFlags(args, { max, pageToken, page, all });
+    return runOrDiagnose(args, { account });
+  });
   server.registerTool("gog_chat_messages_send", {
     description: "Post a message to a Chat space. THIS IS IMMEDIATELY VISIBLE TO EVERYONE IN THE SPACE and cannot be unsent through this tool, so treat it like sending mail, not like saving a draft. Pass `thread` to reply inside an existing conversation (from gog_chat_threads_list or a message's thread field); omit it to start a new one. Text supports Chat's markdown-ish formatting (*bold*, _italic_, `code`)." + workspaceOnlyNote,
     inputSchema: {
@@ -34167,7 +34191,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.27.1" : "0.0.0";
+var VERSION = true ? "2.28.0" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/dist/lib.js

@@ -23325,7 +23325,7 @@ function activeExecutor() {
   return runExecutor.getStore() ?? defaultExecutor;
 }
 var TIMEOUT_MS = 3e4;
-var MIN_GOG_VERSION = "0.38.3";
+var MIN_GOG_VERSION = "0.39.0";
 function readonlyEnvEnabled() {
   return readEnvVar("GOG_READONLY") !== void 0 && parseBoolEnv("GOG_READONLY", { default: true });
 }
@@ -24604,6 +24604,30 @@ function registerChatTools(server) {
     pushPaginationFlags(args, { max, pageToken, page, all });
     return runOrDiagnose(args, { account });
   });
+  server.registerTool("gog_chat_messages_search", {
+    description: 'Search Chat messages ACROSS every space and DM the account can see (gog >= 0.39.0) \u2014 the tool to reach for when the user asks "where did we discuss X" without naming a room, since gog_chat_messages_list needs a space up front. The query is Google Chat filter syntax, so it takes plain keywords or filters like sender, space, date, mention, unread, link and attachment. It is a search, NOT an export: Chat excludes some conversations (muted spaces among them), so an empty result does not prove a message never existed. view="full" adds each hit\'s read state and space mute setting; read state works on an ordinary chat grant, but the mute setting needs chat.users.spacesettings, which gog\'s chat scope set does NOT request (re-auth with extraScopes to get it). Missing metadata is OMITTED rather than defaulted, so an absent `read` means unknown while an explicit false means unread.' + workspaceOnlyNote,
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: external_exports.string().describe('Google Chat filter-syntax query \u2014 keywords, or filters such as "from:alice@example.com budget"'),
+      order: external_exports.enum(["create_time desc", "relevance desc"]).optional().describe(
+        `Sort order. NOTE the snake_case, which differs from gog_chat_messages_list's camelCase. "relevance desc" needs Google Developer Preview access and errors without it`
+      ),
+      view: external_exports.enum(["basic", "full"]).optional().describe(
+        'Result view (default "basic"). "full" also requests read state (covered by an ordinary chat grant) and space mute setting (needs chat.users.spacesettings, which that grant does not include)'
+      ),
+      markup: external_exports.enum(["chat", "markdown"]).optional().describe("Syntax to render each hit's formatted text in"),
+      ...paginationParams,
+      max: external_exports.number().int().min(1).max(100).optional().describe("Max results per page (1-100; Chat search caps a page at 100)"),
+      account: accountParam
+    }
+  }, async ({ query, order, view, markup, max, pageToken, page, all, account }) => {
+    const args = ["chat", "messages", "search", query];
+    if (order) args.push(`--order=${order}`);
+    if (view) args.push(`--view=${view}`);
+    if (markup) args.push(`--markup=${markup}`);
+    pushPaginationFlags(args, { max, pageToken, page, all });
+    return runOrDiagnose(args, { account });
+  });
   server.registerTool("gog_chat_messages_send", {
     description: "Post a message to a Chat space. THIS IS IMMEDIATELY VISIBLE TO EVERYONE IN THE SPACE and cannot be unsent through this tool, so treat it like sending mail, not like saving a draft. Pass `thread` to reply inside an existing conversation (from gog_chat_threads_list or a message's thread field); omit it to start a new one. Text supports Chat's markdown-ish formatting (*bold*, _italic_, `code`)." + workspaceOnlyNote,
     inputSchema: {
@@ -26016,7 +26040,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.27.1" : "0.0.0";
+var VERSION = true ? "2.28.0" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "2.27.1",
+  "version": "2.28.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",
@@ -452,6 +452,10 @@
       "name": "gog_chat_messages_list",
       "description": "Read messages in a space, with mentions and reaction summaries"
     },
+    {
+      "name": "gog_chat_messages_search",
+      "description": "Search Chat messages across every space and DM the account can see"
+    },
     {
       "name": "gog_chat_messages_send",
       "description": "Post a message to a Chat space (immediately visible; supports attachments)"

package/mint.yaml

@@ -86,7 +86,7 @@ dependencies:
   # nine pins too.
   - kind: github-release
     repo: openclaw/gogcli
-    tag: v0.38.3
+    tag: v0.39.0
     asset: "gogcli_*_linux_amd64.tar.gz"
     bin: [gog]
 state:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "2.27.1",
+  "version": "2.28.0",
   "mcpName": "io.github.chrischall/gogcli-mcp",
   "description": "MCP server wrapping gogcli for Google service access",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

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

package/src/runner.ts

@@ -217,7 +217,7 @@ const TIMEOUT_MS = 30_000;
 // so the requirement change is surfaced in the release notes (see
 // .github/release.yml). This is the single source of truth for the required
 // version; keep the README/CLAUDE.md mention in sync.
-export const MIN_GOG_VERSION = '0.38.3';
+export const MIN_GOG_VERSION = '0.39.0';
 
 // Interpret the GOG_READONLY kill-switch. `readEnvVar` already treats blank
 // values, 'undefined'/'null' sentinels, and unresolved .mcpb placeholders

package/src/tools/chat.ts

@@ -11,7 +11,7 @@ import type { GogArg } from '../runner.js';
 import { attachInlineParam, inlineAttachmentArgs } from '../attachments.js';
 
 // Google Chat (gog >= 0.38.0 for the mention/reaction metadata in
-// `messages list`; the rest of the surface is older).
+// `messages list`, >= 0.39.0 for `messages search`; the rest is older).
 //
 // TWO NAMING SYSTEMS MEET HERE, and mixing them is the mistake this module's
 // descriptions exist to prevent. Chat identifies everything by RESOURCE NAME —
@@ -135,6 +135,41 @@ export function registerChatTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  server.registerTool('gog_chat_messages_search', {
+    description:
+      'Search Chat messages ACROSS every space and DM the account can see (gog >= 0.39.0) — the tool to reach for when the '
+      + 'user asks "where did we discuss X" without naming a room, since gog_chat_messages_list needs a space up front. '
+      + 'The query is Google Chat filter syntax, so it takes plain keywords or filters like sender, space, date, mention, '
+      + 'unread, link and attachment. It is a search, NOT an export: Chat excludes some conversations (muted spaces among '
+      + 'them), so an empty result does not prove a message never existed. view="full" adds each hit\'s read state and space '
+      + 'mute setting; read state works on an ordinary chat grant, but the mute setting needs chat.users.spacesettings, '
+      + 'which gog\'s chat scope set does NOT request (re-auth with extraScopes to get it). Missing metadata is OMITTED '
+      + 'rather than defaulted, so an absent `read` means unknown while an explicit false means unread.' + workspaceOnlyNote,
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: z.string().describe('Google Chat filter-syntax query — keywords, or filters such as "from:alice@example.com budget"'),
+      order: z.enum(['create_time desc', 'relevance desc']).optional().describe(
+        'Sort order. NOTE the snake_case, which differs from gog_chat_messages_list\'s camelCase. "relevance desc" needs '
+        + 'Google Developer Preview access and errors without it',
+      ),
+      view: z.enum(['basic', 'full']).optional().describe(
+        'Result view (default "basic"). "full" also requests read state (covered by an ordinary chat grant) and space '
+        + 'mute setting (needs chat.users.spacesettings, which that grant does not include)',
+      ),
+      markup: z.enum(['chat', 'markdown']).optional().describe('Syntax to render each hit\'s formatted text in'),
+      ...paginationParams,
+      max: z.number().int().min(1).max(100).optional().describe('Max results per page (1-100; Chat search caps a page at 100)'),
+      account: accountParam,
+    },
+  }, async ({ query, order, view, markup, max, pageToken, page, all, account }) => {
+    const args = ['chat', 'messages', 'search', query];
+    if (order) args.push(`--order=${order}`);
+    if (view) args.push(`--view=${view}`);
+    if (markup) args.push(`--markup=${markup}`);
+    pushPaginationFlags(args, { max, pageToken, page, all });
+    return runOrDiagnose(args, { account });
+  });
+
   server.registerTool('gog_chat_messages_send', {
     description:
       'Post a message to a Chat space. THIS IS IMMEDIATELY VISIBLE TO EVERYONE IN THE SPACE and cannot be unsent through '

package/src/worker.ts

@@ -38,7 +38,7 @@ import { gogAuth, CONNECTOR_INSTRUCTIONS, type GogProps } from './connector-auth
 // connector with all ~360 tools at once. Add whichever paths you want as separate
 // connectors in claude.ai (each authorizes with the same connector key).
 
-const VERSION = '2.27.1'; // x-release-please-version
+const VERSION = '2.28.0'; // x-release-please-version
 
 // Build an McpAgent subclass whose init() registers `registrars` onto its server,
 // each handler wrapped in the ALS scope carrying the per-session Fly executor.

package/tests/tools/chat.test.ts

@@ -46,7 +46,7 @@ describe('gog_chat_spaces_list', () => {
       return undefined as never;
     });
     registerChatTools(server);
-    expect(configs.size).toBe(12);
+    expect(configs.size).toBe(13);
     for (const [name, config] of configs) {
       expect(config.description, name).toMatch(/consumer accounts|Workspace/i);
     }
@@ -132,6 +132,66 @@ describe('gog_chat_messages_list', () => {
   });
 });
 
+describe('gog_chat_messages_search', () => {
+  it('searches across every space the account can see', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{"results":[]}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_chat_messages_search', { query: 'project decision' });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['chat', 'messages', 'search', 'project decision'],
+      { account: undefined },
+    );
+  });
+
+  it('passes view, markup, order and pagination flags', async () => {
+    vi.mocked(runner.run).mockResolvedValue('{"results":[]}');
+    const harness = await setupHandlers();
+    await harness.callTool('gog_chat_messages_search', {
+      query: 'from:alice@example.com budget',
+      view: 'full',
+      markup: 'markdown',
+      order: 'create_time desc',
+      max: 100,
+      pageToken: 'tok',
+      all: true,
+    });
+    expect(runner.run).toHaveBeenCalledWith(
+      ['chat', 'messages', 'search', 'from:alice@example.com budget', '--order=create_time desc',
+        '--view=full', '--markup=markdown', '--max=100', '--page=tok', '--all'],
+      { account: undefined },
+    );
+  });
+
+  // Chat's own ordering vocabulary is snake_case here and camelCase in
+  // `messages list`; a model that copies the list tool's "createTime desc"
+  // would get a gog error at runtime, so the enum has to reject it here.
+  it('rejects an order value search does not accept', async () => {
+    const harness = await setupHandlers();
+    const result = await harness.callTool('gog_chat_messages_search', {
+      query: 'x', order: 'createTime desc',
+    });
+    expect(result.isError).toBe(true);
+    expect(runner.run).not.toHaveBeenCalled();
+  });
+
+  // Chat caps a search page at 100; `messages list` allows more. Letting the
+  // larger number through would surface as a gog error on a call the tool
+  // already had enough information to refuse.
+  it('rejects a page size above Chat search\'s cap of 100', async () => {
+    const harness = await setupHandlers();
+    const result = await harness.callTool('gog_chat_messages_search', { query: 'x', max: 250 });
+    expect(result.isError).toBe(true);
+    expect(runner.run).not.toHaveBeenCalled();
+  });
+
+  it('returns error text on failure', async () => {
+    vi.mocked(runner.run).mockRejectedValue(new Error('Search failed'));
+    const harness = await setupHandlers();
+    const result = await harness.callTool('gog_chat_messages_search', { query: 'x' });
+    expect(result.content[0].text).toBe('Error: Search failed');
+  });
+});
+
 describe('gog_chat_messages_send', () => {
   it('sends text to a space', async () => {
     vi.mocked(runner.run).mockResolvedValue('{}');