grr

Overview Schema Source Related Servers Discussions Admin

chat.spaces.findGroupChats

Finds Google Chat group conversations that include the calling user and specified human users, returning matching spaces with pagination and view options.

Instructions

Returns all spaces with spaceType == GROUP_CHAT, whose human memberships contain exactly the calling user, and the users specified in FindGroupChatsRequest.users. Only members that have joined the conversation are supported. For an example, see Find group chats. If the calling user blocks, or is blocked by, some users, and no spaces with the entire specified set of users are found, this method returns spaces that don't include the blocked or blocking users. The specified set of users must contain only human (non-app) membersh [HTTP GET]. Returns the requested resource as JSON — request bodies are built from the typed parameters (typed flags win over the params map), or read whole from body_file Siblings over the same resource: completeImport, create, delete, findDirectMessage, get, list, patch, search, setup.

Input Schema

Name	Required	Description
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`users`	No
`params`	No	Parameter map merged into the request; typed parameters win.
`dry_run`	No	Return the request that would be sent, without sending it.
`pageSize`	No	[query parameter] Optional. The maximum number of spaces to return. The service might return fewer than this value. If unspecified, at most 10 spaces are returned. The maximum va
`body_file`	No	Read the request body from this file ('-' for stdin) instead of building one from the parameters.
`pageToken`	No	[query parameter] Optional. A page token, received from a previous call to find group chats. Provide this parameter to retrieve the subsequent page. When paginating, all other pa
`spaceView`	No	[query parameter] Requested space view type. If unset, defaults to `SPACE_VIEW_RESOURCE_NAME_ONLY`. Requests that specify `SPACE_VIEW_EXPANDED` must include scopes that allow rea Values: `SPACE_VIEW_UNSPECIFIED` = The default / unset value.; `SPACE_VIEW_RESOURCE_NAME_ONLY` = Populates only the Space resource name.; `SPACE_VIEW_EXPANDED` = Populates Space resource fields. Note: the `permissionSettings` field will not be populated. Requests that specify SPACE_VIEW_EXPANDED must include scopes that allow reading space data, for example, https://www.googleapis.com/auth/chat.spaces or https://www.googleapis.com/auth/chat.spaces.readonly..

Output Schema

Name	Required	Description	Default
`spaces`	No
`nextPageToken`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedOct 26, 2026

changedInput schema / properties / pageSize / description

Previous value: -"Optional. The maximum number of spaces to return. The service might return fewer than this value. If unspecified, at most 10 spaces are returned. The maximum va"New value: +"[query parameter] Optional. The maximum number of spaces to return. The service might return fewer than this value. If unspecified, at most 10 spaces are returned. The maximum va"

addedInput schema / properties / pageSize / format
```
Added value: +"int32"
```

changedInput schema / properties / pageToken / description

Previous value: -"Optional. A page token, received from a previous call to find group chats. Provide this parameter to retrieve the subsequent page. When paginating, all other pa"New value: +"[query parameter] Optional. A page token, received from a previous call to find group chats. Provide this parameter to retrieve the subsequent page. When paginating, all other pa"

changedInput schema / properties / spaceView / description

Previous value: -"Requested space view type. If unset, defaults to `SPACE_VIEW_RESOURCE_NAME_ONLY`. Requests that specify `SPACE_VIEW_EXPANDED` must include scopes that allow rea"New value: +"[query parameter] Requested space view type. If unset, defaults to `SPACE_VIEW_RESOURCE_NAME_ONLY`. Requests that specify `SPACE_VIEW_EXPANDED` must include scopes that allow rea Values: `SPACE_VIEW_UNSPECIFIED` = The default / unset value.; `SPACE_VIEW_RESOURCE_NAME_ONLY` = Populates only the Space resource name.; `SPACE_VIEW_EXPANDED` = Populates Space resource fields. Note: the `permissionSettings` field will not be populated. Requests that specify SPACE_VIEW_EXPANDED must include scopes that allow reading space data, for example, https://www.googleapis.com/auth/chat.spaces or https://www.googleapis.com/auth/chat.spaces.readonly.."

changedInput schema / properties / users / items / description

Previous value: -"Optional. Resource names of all human users in group chat with the calling user. Chat apps can't be included in the request. The maximum number of users that ca"New value: +"[query parameter] Optional. Resource names of all human users in group chat with the calling user. Chat apps can't be included in the request. The maximum number of users that ca"

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "nextPageToken": {
+      "type": "string"
+    },
+    "spaces": {
+      "items": {
+        "properties": {
+          "accessSettings": {
+            "properties": {
+              "accessPermissionSettings": {
+                "properties": {
+                  "discoverSpaceSetting": {
+                    "type": "object"
+                  },
+                  "joinSpaceSetting": {
+                    "type": "object"
+                  },
+                  "viewSpaceMembershipSetting": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "accessState": {
+                "enum": [
+                  "ACCESS_STATE_UNSPECIFIED",
+                  "PRIVATE",
+                  "DISCOVERABLE"
+                ],
+                "type": "string"
+              },
+              "audience": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "adminInstalled": {
+            "type": "boolean"
+          },
+          "createTime": {
+            "type": "string"
+          },
+          "customer": {
+            "type": "string"
+          },
+          "displayName": {
+            "type": "string"
+          },
+          "externalUserAllowed": {
+            "type": "boolean"
+          },
+          "importMode": {
+            "type": "boolean"
+          },
+          "importModeExpireTime": {
+            "type": "string"
+          },
+          "lastActiveTime": {
+            "type": "string"
+          },
+          "membershipCount": {
+            "properties": {
+              "joinedDirectHumanUserCount": {
+                "type": "integer"
+              },
+              "joinedGroupCount": {
+                "type": "integer"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "permissionSettings": {
+            "properties": {
+              "manageApps": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "manageMembersAndGroups": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "manageWebhooks": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "modifySpaceDetails": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "postMessages": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "replyMessages": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "toggleHistory": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "useAtMentionAll": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              },
+              "viewSpaceMembership": {
+                "properties": {
+                  "assistantManagersAllowed": {
+                    "type": "boolean"
+                  },
+                  "managersAllowed": {
+                    "type": "boolean"
+                  },
+                  "membersAllowed": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "predefinedPermissionSettings": {
+            "enum": [
+              "PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED",
+              "COLLABORATION_SPACE",
+              "ANNOUNCEMENT_SPACE"
+            ],
+            "type": "string"
+          },
+          "singleUserBotDm": {
+            "type": "boolean"
+          },
+          "spaceDetails": {
+            "properties": {
+              "description": {
+                "type": "string"
+              },
+              "guidelines": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "spaceHistoryState": {
+            "enum": [
+              "HISTORY_STATE_UNSPECIFIED",
+              "HISTORY_OFF",
+              "HISTORY_ON"
+            ],
+            "type": "string"
+          },
+          "spaceThreadingState": {
+            "enum": [
+              "SPACE_THREADING_STATE_UNSPECIFIED",
+              "THREADED_MESSAGES",
+              "GROUPED_MESSAGES",
+              "UNTHREADED_MESSAGES"
+            ],
+            "type": "string"
+          },
+          "spaceType": {
+            "enum": [
+              "SPACE_TYPE_UNSPECIFIED",
+              "SPACE",
+              "GROUP_CHAT",
+              "DIRECT_MESSAGE"
+            ],
+            "type": "string"
+          },
+          "spaceUri": {
+            "type": "string"
+          },
+          "threaded": {
+            "type": "boolean"
+          },
+          "type": {
+            "enum": [
+              "TYPE_UNSPECIFIED",
+              "ROOM",
+              "DM"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

First observedOct 26, 2026

TDQS

A4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden and does well: it declares HTTP GET (read semantics), discloses that only joined members are supported, that the result set degrades when users block each other, and that only human memberships count. It is undercut by a truncated sentence ('non-app) membersh') and no statement of auth/scope requirements beyond what the spaceView param schema already says.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core purpose is front-loaded in the first sentence, which is good. But the tail contains generic wrapper boilerplate about `params`, `body_file`, and 'request bodies are built from typed parameters' that is irrelevant for a GET with no body, and several sentences are visibly truncated, wasting space without informing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-shape explanation is unnecessary, and the description covers the non-obvious parts (set-exactness, blocking fallback, human-only constraint) that an agent could not infer from the schema. Remaining gaps are minor pagination/scope details that live in the parameter descriptions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 88%, so baseline is 3, and the description goes further by explaining the meaning of `users` (exactly the calling user plus the listed humans, apps excluded) and the behavioral consequence when that set cannot be satisfied. It adds no guidance on pageSize/pageToken or spaceView, but those are documented in-schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource with a precise filter: spaces where spaceType == GROUP_CHAT whose human memberships contain exactly the calling user plus the users specified in the request. The GROUP_CHAT scoping functionally distinguishes it from chat.spaces.list, chat.spaces.search, and chat.spaces.findDirectMessage without needing to open their schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Describes the exact set-membership semantics and the blocked-user fallback, which implicitly tells the agent when results may be broader than requested. However, it never names the sibling alternatives (list, search, findDirectMessage) or says when to prefer one over another, leaving routing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server