grr

Overview Schema Source Related Servers Discussions Admin

chat.spaces.spaceEvents.list

Lists events from a Google Chat space, including membership changes, so you can track space activity and retrieve filtered event payloads.

Instructions

Lists events from a Google Chat space. For each event, the payload contains the most recent version of the Chat resource. For example, if you list events about new space members, the server returns Membership resources that contain the latest membership details. If new members were removed during the requested period, the event payload contains an empty Membership resource. Supports the following types of [authentication](https://developers.google.com/workspace/chat/auth [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: get.

Input Schema

Name	Required	Description
`query`	No	Extra KEY=VALUE query pairs for endpoints whose parameters Discovery does not describe.
`filter`	No	[query parameter] Required. A query filter. You must specify at least one event type (`event_type`) using the has `:` operator. To filter by multiple event types, use the `OR` op
`params`	No	Parameter map merged into the request; typed parameters win.
`parent`	Yes	[URL path segment] Required. Resource name of the [Google Chat space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) where the events occurred. Format:
`dry_run`	No	Return the request that would be sent, without sending it.
`pageSize`	No	[query parameter] Optional. The maximum number of space events returned. The service might return fewer than this value. Negative values return an `INVALID_ARGUMENT` error.
`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 list space events call. Provide this to retrieve the subsequent page. When paginating, all other parameters pro

Output Schema

Name	Required	Description	Default
`spaceEvents`	No
`nextPageToken`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedOct 26, 2026

changedInput schema / properties / filter / description

Previous value: -"Required. A query filter. You must specify at least one event type (`event_type`) using the has `:` operator. To filter by multiple event types, use the `OR` op"New value: +"[query parameter] Required. A query filter. You must specify at least one event type (`event_type`) using the has `:` operator. To filter by multiple event types, use the `OR` op"

changedInput schema / properties / pageSize / description

Previous value: -"Optional. The maximum number of space events returned. The service might return fewer than this value. Negative values return an `INVALID_ARGUMENT` error."New value: +"[query parameter] Optional. The maximum number of space events returned. The service might return fewer than this value. Negative values return an `INVALID_ARGUMENT` error."

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

changedInput schema / properties / pageToken / description

Previous value: -"Optional. A page token, received from a previous list space events call. Provide this to retrieve the subsequent page. When paginating, all other parameters pro"New value: +"[query parameter] Optional. A page token, received from a previous list space events call. Provide this to retrieve the subsequent page. When paginating, all other parameters pro"

changedInput schema / properties / parent / description

Previous value: -"Required. Resource name of the [Google Chat space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) where the events occurred. Format:"New value: +"[URL path segment] Required. Resource name of the [Google Chat space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) where the events occurred. Format:"

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

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "nextPageToken": {
+      "type": "string"
+    },
+    "spaceEvents": {
+      "items": {
+        "properties": {
+          "eventTime": {
+            "type": "string"
+          },
+          "eventType": {
+            "type": "string"
+          },
+          "membershipBatchCreatedEventData": {
+            "properties": {
+              "memberships": {
+                "items": {
+                  "properties": {
+                    "membership": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "membershipBatchDeletedEventData": {
+            "properties": {
+              "memberships": {
+                "items": {
+                  "properties": {
+                    "membership": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "membershipBatchUpdatedEventData": {
+            "properties": {
+              "memberships": {
+                "items": {
+                  "properties": {
+                    "membership": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "membershipCreatedEventData": {
+            "properties": {
+              "membership": {
+                "properties": {
+                  "affiliation": {
+                    "enum": [
+                      "AFFILIATION_UNSPECIFIED",
+                      "INTERNAL",
+                      "EXTERNAL",
+                      "MANAGED_EXTERNAL"
+                    ],
+                    "type": "string"
+                  },
+                  "createTime": {
+                    "type": "string"
+                  },
+                  "deleteTime": {
+                    "type": "string"
+                  },
+                  "groupMember": {
+                    "type": "object"
+                  },
+                  "member": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "role": {
+                    "enum": [
+                      "MEMBERSHIP_ROLE_UNSPECIFIED",
+                      "ROLE_MEMBER",
+                      "ROLE_MANAGER",
+                      "ROLE_ASSISTANT_MANAGER"
+                    ],
+                    "type": "string"
+                  },
+                  "state": {
+                    "enum": [
+                      "MEMBERSHIP_STATE_UNSPECIFIED",
+                      "JOINED",
+                      "INVITED",
+                      "NOT_A_MEMBER"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "membershipDeletedEventData": {
+            "properties": {
+              "membership": {
+                "properties": {
+                  "affiliation": {
+                    "enum": [
+                      "AFFILIATION_UNSPECIFIED",
+                      "INTERNAL",
+                      "EXTERNAL",
+                      "MANAGED_EXTERNAL"
+                    ],
+                    "type": "string"
+                  },
+                  "createTime": {
+                    "type": "string"
+                  },
+                  "deleteTime": {
+                    "type": "string"
+                  },
+                  "groupMember": {
+                    "type": "object"
+                  },
+                  "member": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "role": {
+                    "enum": [
+                      "MEMBERSHIP_ROLE_UNSPECIFIED",
+                      "ROLE_MEMBER",
+                      "ROLE_MANAGER",
+                      "ROLE_ASSISTANT_MANAGER"
+                    ],
+                    "type": "string"
+                  },
+                  "state": {
+                    "enum": [
+                      "MEMBERSHIP_STATE_UNSPECIFIED",
+                      "JOINED",
+                      "INVITED",
+                      "NOT_A_MEMBER"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "membershipUpdatedEventData": {
+            "properties": {
+              "membership": {
+                "properties": {
+                  "affiliation": {
+                    "enum": [
+                      "AFFILIATION_UNSPECIFIED",
+                      "INTERNAL",
+                      "EXTERNAL",
+                      "MANAGED_EXTERNAL"
+                    ],
+                    "type": "string"
+                  },
+                  "createTime": {
+                    "type": "string"
+                  },
+                  "deleteTime": {
+                    "type": "string"
+                  },
+                  "groupMember": {
+                    "type": "object"
+                  },
+                  "member": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "role": {
+                    "enum": [
+                      "MEMBERSHIP_ROLE_UNSPECIFIED",
+                      "ROLE_MEMBER",
+                      "ROLE_MANAGER",
+                      "ROLE_ASSISTANT_MANAGER"
+                    ],
+                    "type": "string"
+                  },
+                  "state": {
+                    "enum": [
+                      "MEMBERSHIP_STATE_UNSPECIFIED",
+                      "JOINED",
+                      "INVITED",
+                      "NOT_A_MEMBER"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "messageBatchCreatedEventData": {
+            "properties": {
+              "messages": {
+                "items": {
+                  "properties": {
+                    "message": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "messageBatchDeletedEventData": {
+            "properties": {
+              "messages": {
+                "items": {
+                  "properties": {
+                    "message": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "messageBatchUpdatedEventData": {
+            "properties": {
+              "messages": {
+                "items": {
+                  "properties": {
+                    "message": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "messageCreatedEventData": {
+            "properties": {
+              "message": {
+                "properties": {
+                  "accessoryWidgets": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "actionResponse": {
+                    "type": "object"
+                  },
+                  "annotations": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "argumentText": {
+                    "type": "string"
+                  },
+                  "attachedGifs": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "attachment": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "cards": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "cardsV2": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "clientAssignedMessageId": {
+                    "type": "string"
+                  },
+                  "createTime": {
+                    "type": "string"
+                  },
+                  "deleteTime": {
+                    "type": "string"
+                  },
+                  "deletionMetadata": {
+                    "type": "object"
+                  },
+                  "emojiReactionSummaries": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "fallbackText": {
+                    "type": "string"
+                  },
+                  "formattedText": {
+                    "type": "string"
+                  },
+                  "lastUpdateTime": {
+                    "type": "string"
+                  },
+                  "markupSyntax": {
+                    "enum": [
+                      "MARKUP_SYNTAX_UNSPECIFIED",
+                      "MARKUP_SYNTAX_CHAT",
+                      "MARKUP_SYNTAX_MARKDOWN"
+                    ],
+                    "type": "string"
+                  },
+                  "matchedUrl": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "privateMessageViewer": {
+                    "type": "object"
+                  },
+                  "quotedMessageMetadata": {
+                    "type": "object"
+                  },
+                  "sender": {
+                    "type": "object"
+                  },
+                  "silent": {
+                    "type": "boolean"
+                  },
+                  "slashCommand": {
+                    "type": "object"
+                  },
+                  "space": {
+                    "type": "object"
+                  },
+                  "text": {
+                    "type": "string"
+                  },
+                  "thread": {
+                    "type": "object"
+                  },
+                  "threadReply": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "messageDeletedEventData": {
+            "properties": {
+              "message": {
+                "properties": {
+                  "accessoryWidgets": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "actionResponse": {
+                    "type": "object"
+                  },
+                  "annotations": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "argumentText": {
+                    "type": "string"
+                  },
+                  "attachedGifs": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "attachment": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "cards": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "cardsV2": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "clientAssignedMessageId": {
+                    "type": "string"
+                  },
+                  "createTime": {
+                    "type": "string"
+                  },
+                  "deleteTime": {
+                    "type": "string"
+                  },
+                  "deletionMetadata": {
+                    "type": "object"
+                  },
+                  "emojiReactionSummaries": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "fallbackText": {
+                    "type": "string"
+                  },
+                  "formattedText": {
+                    "type": "string"
+                  },
+                  "lastUpdateTime": {
+                    "type": "string"
+                  },
+                  "markupSyntax": {
+                    "enum": [
+                      "MARKUP_SYNTAX_UNSPECIFIED",
+                      "MARKUP_SYNTAX_CHAT",
+                      "MARKUP_SYNTAX_MARKDOWN"
+                    ],
+                    "type": "string"
+                  },
+                  "matchedUrl": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "privateMessageViewer": {
+                    "type": "object"
+                  },
+                  "quotedMessageMetadata": {
+                    "type": "object"
+                  },
+                  "sender": {
+                    "type": "object"
+                  },
+                  "silent": {
+                    "type": "boolean"
+                  },
+                  "slashCommand": {
+                    "type": "object"
+                  },
+                  "space": {
+                    "type": "object"
+                  },
+                  "text": {
+                    "type": "string"
+                  },
+                  "thread": {
+                    "type": "object"
+                  },
+                  "threadReply": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "messageUpdatedEventData": {
+            "properties": {
+              "message": {
+                "properties": {
+                  "accessoryWidgets": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "actionResponse": {
+                    "type": "object"
+                  },
+                  "annotations": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "argumentText": {
+                    "type": "string"
+                  },
+                  "attachedGifs": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "attachment": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "cards": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "cardsV2": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "clientAssignedMessageId": {
+                    "type": "string"
+                  },
+                  "createTime": {
+                    "type": "string"
+                  },
+                  "deleteTime": {
+                    "type": "string"
+                  },
+                  "deletionMetadata": {
+                    "type": "object"
+                  },
+                  "emojiReactionSummaries": {
+                    "items": {
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "fallbackText": {
+                    "type": "string"
+                  },
+                  "formattedText": {
+                    "type": "string"
+                  },
+                  "lastUpdateTime": {
+                    "type": "string"
+                  },
+                  "markupSyntax": {
+                    "enum": [
+                      "MARKUP_SYNTAX_UNSPECIFIED",
+                      "MARKUP_SYNTAX_CHAT",
+                      "MARKUP_SYNTAX_MARKDOWN"
+                    ],
+                    "type": "string"
+                  },
+                  "matchedUrl": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "privateMessageViewer": {
+                    "type": "object"
+                  },
+                  "quotedMessageMetadata": {
+                    "type": "object"
+                  },
+                  "sender": {
+                    "type": "object"
+                  },
+                  "silent": {
+                    "type": "boolean"
+                  },
+                  "slashCommand": {
+                    "type": "object"
+                  },
+                  "space": {
+                    "type": "object"
+                  },
+                  "text": {
+                    "type": "string"
+                  },
+                  "thread": {
+                    "type": "object"
+                  },
+                  "threadReply": {
+                    "type": "boolean"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          },
+          "reactionBatchCreatedEventData": {
+            "properties": {
+              "reactions": {
+                "items": {
+                  "properties": {
+                    "reaction": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "reactionBatchDeletedEventData": {
+            "properties": {
+              "reactions": {
+                "items": {
+                  "properties": {
+                    "reaction": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "reactionCreatedEventData": {
+            "properties": {
+              "reaction": {
+                "properties": {
+                  "emoji": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "user": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "reactionDeletedEventData": {
+            "properties": {
+              "reaction": {
+                "properties": {
+                  "emoji": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "user": {
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              }
+            },
+            "type": "object"
+          },
+          "spaceBatchUpdatedEventData": {
+            "properties": {
+              "spaces": {
+                "items": {
+                  "properties": {
+                    "space": {
+                      "type": "object"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "spaceUpdatedEventData": {
+            "properties": {
+              "space": {
+                "properties": {
+                  "accessSettings": {
+                    "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": {
+                    "type": "object"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "permissionSettings": {
+                    "type": "object"
+                  },
+                  "predefinedPermissionSettings": {
+                    "enum": [
+                      "PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED",
+                      "COLLABORATION_SPACE",
+                      "ANNOUNCEMENT_SPACE"
+                    ],
+                    "type": "string"
+                  },
+                  "singleUserBotDm": {
+                    "type": "boolean"
+                  },
+                  "spaceDetails": {
+                    "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": "object"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

First observedOct 26, 2026

TDQS

B3.2/5.0

Behavior3/5

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

No annotations, so the description carries the burden. It does meaningfully explain payload behavior (returns most recent resource version; empty Membership for removed members), which is real behavioral value. However, the authentication section is truncated/broken and pagination, permissions, and rate limits are not addressed.

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

Conciseness2/5

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

Front-loads purpose, but the body contains a broken markdown link ('[authentication](... [HTTP GET]'), generic boilerplate about params/body_file that reads as template text, and a trailing fragment 'Siblings over the same resource: get.' The valuable payload example is diluted by clutter.

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

Completeness3/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 values needn't be explained, and the payload semantics are covered. But the authentication portion is truncated and pagination behavior is left entirely to the schema, leaving the description only partially complete for an 8-parameter list tool.

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

Parameters3/5

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

Schema coverage is 100%, so parameters are already documented; the description adds no per-parameter meaning beyond what the schema provides. Baseline 3 applies since the schema does the heavy lifting.

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?

States a specific verb and resource ('Lists events from a Google Chat space') and ends by naming the sibling over the same resource ('Siblings over the same resource: get'). The payload semantics illustrate what 'event' means, though the opening distinguishes it clearly from get only partially.

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?

Mentions the sibling 'get' but does not state when to use list versus get, nor prerequisites. Usage is implied by 'lists events' and the filter requirement in the schema, but the description offers no explicit when/when-not guidance.

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

Deploy Server