MCP Tools Reference: chatmcp.googleapis.com

Tool: list_memberships

Lists memberships in a Google Chat conversation.

The following code sample shows how to use curl to call the list_memberships MCP tool.

Curl Request 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_memberships",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

ListMembershipsRequest

JSON representation 
{
  "conversationId": string,
  "pageSize": integer,
  "pageToken": string,
  "membershipFilter": enum (MembershipFilter)
}
Fields
conversationId

string

Required. The ID of the conversation to list memberships for. Format: spaces/{space}
pageSize

integer

Optional. The maximum number of memberships to return. The service may return fewer than this value. If unspecified or set to a non-positive value, a default value of 20 is used. The maximum allowed value is 50.
pageToken

string

Optional. A page token, received from a previous list_memberships call. Provide this to retrieve the subsequent page.
membershipFilter

enum (MembershipFilter)

Optional. Specifies the subset of memberships to return. If unspecified, only JOINED memberships are returned.

MembershipFilter

Specifies the subset of memberships to return.

Enums
MEMBERSHIP_FILTER_UNSPECIFIED Default value. If unspecified, returns only JOINED memberships.
JOINED_ONLY Returns only JOINED memberships.
JOINED_AND_INVITED Returns JOINED and INVITED memberships.

Output Schema

Response containing the list of memberships in the conversation.

ListMembershipsResponse

JSON representation 
{
  "memberships": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string
}
Fields
memberships[]

object (Membership)

List of memberships in the requested conversation.
nextPageToken

string

A token that can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Membership

JSON representation 
{
  "member": {
    object (User)
  },
  "state": enum (State),
  "role": enum (Role)
}
Fields
member

object (User)

The user that is a member.
state

enum (State)

Output only. State of the membership.
role

enum (Role)

Role of the member.

User

JSON representation 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Fields
userId

string

Resource name of a Chat user. Format: users/{user}.
displayName

string

The display name of a Chat user.
email

string

The email address of the user. This field is only populated when the user type is HUMAN.
userType

enum (UserType)

The type of the user.

UserType

The type of a Google Chat user.

Enums
USER_TYPE_UNSPECIFIED Unspecified.
HUMAN Human user.
APP App user.

State

State of the membership.

Enums
STATE_UNSPECIFIED Unspecified.
JOINED The user is a member of the space.
INVITED The user is invited to join the space.

Role

Role of the member.

Enums
ROLE_UNSPECIFIED Unspecified.
MEMBER The user is a member of the space.
MANAGER The user is a manager of the space.
ASSISTANT_MANAGER The user is an assistant manager of the space.

Tool Annotations

Tool annotations are sent to MCP clients to describe the basic risk of a given tool. Most clients treat these hints as untrusted, but they can be used to decide when a confirmation prompt might be sent to a user.

Along with the title string, the following boolean hints are defined as follows:

  • readOnlyHint: If true, the tool doesn't modify its environment. Default: false.
  • destructiveHint: If true, then the tool can perform destructive actions. If false, then the tool can only perform additive actions. Default: true.
  • idempotentHint: If true, then calling the tool repeatedly with the same arguments will have no additional effect on its environment. Default: false.
  • openWorldHint: If true, then the tool can interact with an 'open world' of external entities. If false, then the tool can only interact with internal entities. For example, a web search tool would be open world, while a memory tool would not be open world.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly