grr

Overview Schema Source Related Servers Discussions Admin

chat.spaces.get

Retrieve details about a Google Chat space by its resource name, using app or user authentication. Returns the space resource as JSON for scripts and admin workflows.

Instructions

Returns details about a space. For an example, see Get details about a space. Supports the following types of authentication: - App authentication with one of the following authorization scopes: - https://www.googleapis.com/auth/chat.bot - https://www.googleapis.com/auth/chat.app.spaces with administrator approval - [User authentication [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, findGroupChats, list, patch, search, setup.

Input Schema

Name	Required	Description
`name`	Yes	[URL path segment] Required. Resource name of the space, in the form `spaces/{space}`. Format: `spaces/{space}`
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`params`	No	Parameter map merged into the request; typed parameters win.
`dry_run`	No	Return the request that would be sent, without sending it.
`body_file`	No	Read the request body from this file ('-' for stdin) instead of building one from the parameters.
`useAdminAccess`	No	[query parameter] Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator wit

Output Schema

Name	Required	Description	Default
`name`	No
`type`	No
`customer`	No
`spaceUri`	No
`threaded`	No
`spaceType`	No
`createTime`	No
`importMode`	No
`displayName`	No
`spaceDetails`	No
`accessSettings`	No
`adminInstalled`	No
`lastActiveTime`	No
`membershipCount`	No
`singleUserBotDm`	No
`spaceHistoryState`	No
`permissionSettings`	No
`externalUserAllowed`	No
`spaceThreadingState`	No
`importModeExpireTime`	No
`predefinedPermissionSettings`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedOct 26, 2026

changedInput schema / properties / name / description

Previous value: -"Required. Resource name of the space, in the form `spaces/{space}`. Format: `spaces/{space}`"New value: +"[URL path segment] Required. Resource name of the space, in the form `spaces/{space}`. Format: `spaces/{space}`"

addedInput schema / properties / name / pattern
```
Added value: +"^spaces/[^/]+$"
```

changedInput schema / properties / useAdminAccess / description

Previous value: -"Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator wit"New value: +"[query parameter] Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator wit"

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "accessSettings": {
+      "properties": {
+        "accessPermissionSettings": {
+          "properties": {
+            "discoverSpaceSetting": {
+              "properties": {
+                "principals": {
+                  "items": {
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "joinSpaceSetting": {
+              "properties": {
+                "principals": {
+                  "items": {
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            },
+            "viewSpaceMembershipSetting": {
+              "properties": {
+                "principals": {
+                  "items": {
+                    "type": "object"
+                  },
+                  "type": "array"
+                }
+              },
+              "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"
+}

First observedOct 26, 2026

TDQS

A4.1/5.0

Behavior4/5

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

With no annotations, the description carries the load and does disclose meaningful traits: it is an HTTP GET (read-only), and it enumerates the required auth modes and scopes, including administrator approval for chat.app.spaces. It does not cover error behavior or permission failure modes, but the auth profile is well beyond typical.

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

Conciseness4/5

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

Purpose is front-loaded in the first sentence and the essentials follow. Some bulk is inherited boilerplate (request-body/`body_file` mechanics on a GET that needs no body) and two example/scope URLs, but nothing is seriously misleading.

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

Completeness5/5

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

The tool is a single-resource getter with a fully described 6-parameter schema and an output schema, so return shape needs no explanation. The description adds auth requirements and parameter-override mechanics, leaving no material gap for correct invocation.

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

Parameters5/5

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

Schema coverage is 100%, so the baseline is 3, but the description goes further by explaining the generic mechanics: request bodies are built from typed parameters, typed flags win over the `params` map, and `body_file` can supply the whole body. That precedence rule is not obvious from the schema alone and directly affects how an agent fills these 6 parameters.

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

Purpose4/5

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

"Returns details about a space" gives a specific verb (get/details) and resource (space), which is distinguishable from create/patch/delete/list. The trailing sibling enumeration reinforces what this is not, though it is a bare name list rather than an explanation of the distinction.

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?

Usage is only implied: use it to fetch details of a known space (name required), versus list/search/findDirectMessage for discovery. It states authentication prerequisites, which is useful context, but never explicitly says when to prefer get over the listed siblings or what conditions rule it out.

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

Deploy Server