Google Chat: List space members — MCP tool

Google Chat MCP tool: Lists the memberships of a space — who is in it, with which role and state.

Technical name: list_members

What task it solves

I want to see who is in a Google Chat space.

Returns memberships: name (spaces/<space>/members/<member> — the handle manage_members needs), member (users/<id>, displayName, HUMAN|BOT), role (member or manager) and state (JOINED, INVITED, NOT_A_MEMBER).

When to use it

Use it before membership changes (to find the member_name and check who is a manager), or to audit a space's roster.

What to provide

• space — required. spaces/<id> or the bare id.
• role — optional. Only member or only manager memberships.
• show_invited — optional. Include invited-but-not-joined users.
• show_groups — optional. Include Google Group memberships.
• page_size, page_token — optional pagination (1..1000, default 100).

What it returns

A page of memberships with nextPageToken when more exist.

What changes in Google Chat

The tool reads Google Chat data and does not change it.

Example request

Who are the managers of spaces/AAAAAAAAAAA?

Errors and limitations

Requires the chat.memberships.readonly (or chat.memberships) scope and membership in the space. Access also depends on quotas and upstream API limits.

Related MCP tools

• Manage space membership — manage_members
• Get a space — get_space
• List spaces — list_spaces

Technical details

• Impact: read-only
• Group: Members
• Description source: list_members registration in src/tools/members.ts
• Full technical reference
• All MCP capabilities