Google Chat by Apoth3osis

Name: Google Chat
Brand: Apoth3osis
SKU: 6968000436a6023a803ab753
Price: 0.05 USD
Availability: InStock

Google Chat

Connector

Available ActionsEach successful request consumes credits as outlined below.

list_spaces^5crget_space^5crsearch_spaces^5crfind_direct_message^5crlist_messages^5crget_message^5crsearch_messages^5crcreate_message^5crreply_message^5crupdate_message^5crdelete_message^5crlist_reactions^5cradd_reaction^5crdelete_reaction^5crlist_message_attachments^5crget_attachment^5crsearch_attachments^5crupload_attachment^5crdownload_attachment_to_storage^5cr

Details

Bridge your agent to your Google Chat spaces—post updates, keep threads moving, and turn routine teamwork into quick, automated nudges that keep everyone in sync. Supports reactions, direct messaging, and posting and reading in spaces. All actions take place as the connected user.

Use Cases

Search accessible spaces, Find direct-message spaces, Read and search messages, Send messages and replies, Attach File Manager files to Chat messages, Download Chat attachments to File Manager, Add or remove reactions, Automate team notifications

Dynamic MCP Setup

Connect once through AgentPMT Dynamic MCP, then use approved tools from the same agent connection.

30 Second Setup

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections.

npm install -g @agentpmt/mcp-routeragentpmt-setup

Hosted Streamable HTTPS

MCP endpoint for browser-based apps like ChatGPT, Claude, Grok, or any time you want a streamable connection with no local install.

https://api.agentpmt.com/mcp

Config Example

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Full connection guide

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

Need client videos, organization controls, audit details, and the full feature overview?

More About Dynamic MCP

Credentials

Google OAuth *

Connect your Google account.

oauth token

Manage credentials in your dashboard.

Actions(19)

list_spaces^5cr3 params

List accessible spaces.

page_sizeinteger

Page size.

page_tokenstring

Next page token.

filterstring

spaces.list filter.

get_space^5cr1 param(1 required)

Get a space.

spacerequiredstring

Space name or ID.

search_spaces^5cr4 params(1 required)

Search accessible spaces.

queryrequiredstring

Space search query.

page_sizeinteger

Page size.

page_tokenstring

Next page token.

order_bystring

Space sort order.

Values:

create_time DESCrelevance DESC

find_direct_message^5cr1 param(1 required)

Find a DM space.

user_namerequiredstring

User name, e.g. users/123.

list_messages^5cr6 params(1 required)

List messages; newest first by default.

spacerequiredstring

Space name or ID.

page_sizeinteger

Page size.

page_tokenstring

Next page token.

filterstring

Message filter.

order_bystring

Message sort order.

Values:

create_time DESCcreate_time ASCcreateTime DESCcreateTime ASC

show_deletedboolean

Include deleted messages.

get_message^5cr2 params(1 required)

Get a message.

message_namerequiredstring

Message name or ID.

spacestring

Space for short IDs.

search_messages^5cr10 params(2 required)

Bounded message search in one space.

spacerequiredstring

Space name or ID.

queryrequiredstring

Search text.

filterstring

Optional list filter.

order_bystring

Scan sort order.

Values:

create_time DESCcreate_time ASCcreateTime DESCcreateTime ASC

show_deletedboolean

Include deleted messages.

page_sizeinteger

Scan page size.

max_resultsinteger

Max matches.

scan_limitinteger

Max messages scanned.

case_sensitiveboolean

Case-sensitive match.

search_fieldsarray

Fields to search.

Array of: string

create_message^5cr11 params(1 required)

Create a message, optionally with files.

spacerequiredstring

Target space.

textstring

Message text.

cards_v2array

Cards v2 payload.

Array of: object

thread_namestring

Thread name.

thread_keystring

Thread key.

message_reply_optionstring

Reply option.

Values:

REPLY_MESSAGE_FALLBACK_TO_NEW_THREADREPLY_MESSAGE_OR_FAIL

message_request_idstring

Idempotency requestId.

message_idstring

Client message ID.

notification_typestring

Notification type.

Values:

NOTIFICATION_TYPE_NONENOTIFICATION_TYPE_FORCE_NOTIFYNOTIFICATION_TYPE_SILENT

file_idsarray

File Manager IDs to attach.

Array of: string

max_upload_bytesinteger

Max upload bytes.

reply_message^5cr10 params(1 required)

Reply to a message, optionally with files.

message_namerequiredstring

Message name or ID.

spacestring

Space for short IDs.

textstring

Reply text.

cards_v2array

Cards v2 payload.

Array of: object

message_reply_optionstring

Reply option.

Values:

REPLY_MESSAGE_FALLBACK_TO_NEW_THREADREPLY_MESSAGE_OR_FAIL

message_request_idstring

Idempotency requestId.

message_idstring

Client message ID.

notification_typestring

Notification type.

Values:

NOTIFICATION_TYPE_NONENOTIFICATION_TYPE_FORCE_NOTIFYNOTIFICATION_TYPE_SILENT

file_idsarray

File Manager IDs to attach.

Array of: string

max_upload_bytesinteger

Max upload bytes.

update_message^5cr4 params(1 required)

Update message text/cards.

message_namerequiredstring

Message name or ID.

spacestring

Space for short IDs.

textstring

Updated text.

cards_v2array

Updated cards v2.

Array of: object

delete_message^5cr3 params(1 required)

Delete a message.

message_namerequiredstring

Message name or ID.

spacestring

Space for short IDs.

forceboolean

Delete replies too.

list_reactions^5cr5 params(1 required)

List message reactions.

message_namerequiredstring

Message name or ID.

spacestring

Space for short IDs.

page_sizeinteger

Page size.

page_tokenstring

Next page token.

filterstring

Reaction filter.

add_reaction^5cr3 params(2 required)

Add a reaction.

message_namerequiredstring

Message name or ID.

emoji_unicoderequiredstring

Unicode emoji.

spacestring

Space for short IDs.

delete_reaction^5cr3 params(1 required)

Delete a reaction.

reaction_namerequiredstring

Reaction name or ID.

message_namestring

Message for short IDs.

spacestring

Space for short IDs.

list_message_attachments^5cr2 params(1 required)

List message attachments.

message_namerequiredstring

Message name or ID.

spacestring

Space for short IDs.

get_attachment^5cr3 params(1 required)

Get attachment metadata from its message.

attachment_namerequiredstring

Attachment name, ID, or contentName.

message_namestring

Parent message.

spacestring

Space for short IDs.

search_attachments^5cr8 params(2 required)

Bounded attachment search in one space.

spacerequiredstring

Space name or ID.

queryrequiredstring

Search text.

filterstring

Optional list filter.

order_bystring

Scan sort order.

Values:

create_time DESCcreate_time ASCcreateTime DESCcreateTime ASC

page_sizeinteger

Scan page size.

max_resultsinteger

Max matches.

scan_limitinteger

Max messages scanned.

case_sensitiveboolean

Case-sensitive match.

upload_attachment^5cr5 params(2 required)

Upload a File Manager file to Chat.

spacerequiredstring

Target space.

source_file_idrequiredstring

File Manager source ID.

filenamestring

Filename override.

content_typestring

MIME type override.

max_upload_bytesinteger

Max upload bytes.

download_attachment_to_storage^5cr7 params

Download Chat media to File Manager.

attachment_namestring

Attachment name, ID, or contentName.

media_resource_namestring

attachmentDataRef.resourceName.

message_namestring

Parent message.

spacestring

Space for short IDs.

output_filenamestring

Stored filename.

expiration_daysinteger

Expiration days.

max_bytesinteger

Max download bytes.

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "6968000436a6023a803ab753",
    "parameters": {
      "action": "list_spaces"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6968000436a6023a803ab753",
    "parameters": {
        "action": "list_spaces"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6968000436a6023a803ab753",
  parameters: {
    "action": "list_spaces"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6968000436a6023a803ab753",
  parameters: {
    "action": "list_spaces"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below.

Recommended

Credit-Based Access Using AgentAddress

AgentAddress is preferred when an autonomous agent needs persistent file access, stored platform state, or maximum tool use ability across repeated calls.

Open Credit-Based Access Using AgentAddress

Direct x402 Payment

Use direct x402 for independent one-off tool calls that do not require shared files or stored platform state.

Accepted public payments

Stablecoin: USDC
Chains: Base, Arbitrum, Optimism, Polygon, and Avalanche

Direct x402 payments are not enabled for this product; use AgentAddress credit access instead.

Product Skill Package

This product has a published Agent Skill package. Install it when an autonomous agent needs product-specific operating instructions in its local skill registry.

Download SKILL.md View package source OpenClaw listing

OpenClaw install

Copied to clipboard

skills.sh install

Copied to clipboard

Usage Instructions

Usage guidance provided directly by the developer for this product.

Google Chat

Read spaces, list and search messages, send messages, react to messages, and move attachments between Google Chat and AgentPMT File Manager.

This tool uses the existing AgentPMT Google OAuth scopes only:

chat.spaces.readonly
chat.messages
chat.messages.reactions

It does not manage members or users, does not create/update/delete spaces, does not use admin access, and does not expose custom emoji actions. Member listing requires chat.memberships.readonly or chat.memberships, which this connection does not currently have.

Parameters

action (string, required): Action to perform. Default: get_instructions
space (string): Space name or ID, such as "spaces/AAA" or "AAA"
message_name (string): Message resource name, or short message ID when space is provided
reaction_name (string): Reaction resource name, or short reaction ID when message_name is provided
attachment_name (string): Attachment resource name, short attachment ID, or attachment contentName when message_name is provided
media_resource_name (string): Direct attachmentDataRef.resourceName for Chat media download
user_name (string): User resource name, such as "users/123"
query (string): Search query for space/message/attachment search actions
text (string): Message text
cards_v2 (array): Cards v2 payload
thread_name (string): Existing Chat thread resource name
thread_key (string): Thread key for message creation
message_reply_option (string): REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD or REPLY_MESSAGE_OR_FAIL
message_request_id (string): Google Chat requestId for idempotent message creation
message_id (string): Client-assigned Google Chat message ID
notification_type (string): NOTIFICATION_TYPE_NONE, NOTIFICATION_TYPE_FORCE_NOTIFY, or NOTIFICATION_TYPE_SILENT
page_size (integer, default 50): Max results per page. Reactions max is 200.
page_token (string): Pagination token
filter (string): Google Chat filter query
order_by (string): Sort order
show_deleted (boolean, default false): Include deleted messages in message list/search
max_results (integer, default 25): Max client-side search matches
scan_limit (integer, default 500): Max messages scanned by bounded client-side search
case_sensitive (boolean, default false): Use case-sensitive client-side search
search_fields (array): Fields searched by search_messages: text, formatted_text, argument_text, sender, attachment_name
emoji_unicode (string): Unicode emoji for add_reaction
force (boolean, default false): For delete_message, also delete threaded replies
file_ids (array): AgentPMT File Manager file IDs to upload and attach to create_message or reply_message
source_file_id (string): AgentPMT File Manager file ID for upload_attachment
filename (string): Optional upload filename override
content_type (string): Optional upload MIME type override
max_upload_bytes (integer, default 26214400): Max File Manager bytes uploaded to Chat
max_bytes (integer, default 26214400): Max Chat attachment bytes downloaded
output_filename (string): File Manager filename for downloaded attachment
expiration_days (integer, default 7): Stored download expiration, 1-7 days

Sorting

list_messages sends order_by: "create_time DESC" by default, so messages are newest first. Send order_by: "create_time ASC" for oldest first.

Google also accepts legacy camel-case sort aliases from this tool:

{"action":"list_messages","space":"spaces/AAA","order_by":"createTime DESC"}

The tool normalizes that to official Google Chat syntax.

Search

search_spaces is Google server-side search. Non-admin Google Chat search needs a display-name query for useful results:

{"action":"search_spaces","query":"display_name:\"Launch\"","order_by":"relevance DESC"}

search_messages and search_attachments are bounded client-side searches within one space. They page through accessible messages using list_messages, scan up to scan_limit, and return scan_limit_reached when the scan stopped before the space was exhausted. These are not global Google-side full-text search endpoints.

File Upload

Preferred path: attach File Manager files directly when creating or replying to a message.

{
  "action": "create_message",
  "space": "spaces/AAA",
  "text": "Attached is the latest report.",
  "file_ids": ["file-manager-id-1"]
}

Advanced path: use upload_attachment to stage a File Manager file in Chat and return an attachment_data_ref.

{"action":"upload_attachment","space":"spaces/AAA","source_file_id":"file-manager-id-1"}

File uploads require normal authenticated budget context. Admin bypass cannot read budget-scoped File Manager files.

File Download

List attachments on a message:

{"action":"list_message_attachments","message_name":"spaces/AAA/messages/BBB"}

Download an attachment into AgentPMT File Manager:

{
  "action": "download_attachment_to_storage",
  "message_name": "spaces/AAA/messages/BBB",
  "attachment_name": "spaces/AAA/messages/BBB/attachments/ATT",
  "output_filename": "report.pdf"
}

If you already have attachment.attachmentDataRef.resourceName, you can download directly:

{
  "action": "download_attachment_to_storage",
  "media_resource_name": "spaces/AAA/messages/BBB/attachments/ATT/media",
  "output_filename": "report.pdf"
}

get_attachment reads the parent message and finds the attachment in message data. It does not call the bot-only spaces.messages.attachments.get endpoint.

Actions

`get_instructions`

Returns this documentation.

{"action":"get_instructions"}

`list_spaces`

Lists spaces the authenticated user has access to.

Required: none Optional: page_size, page_token, filter

{"action":"list_spaces","page_size":25}

{"action":"list_spaces","filter":"space_type = \"SPACE\""}

`get_space`

Gets a space by resource name or short ID.

Required: space

{"action":"get_space","space":"spaces/AAA"}

`search_spaces`

Searches accessible spaces with Google Chat server-side space search. Admin access is not exposed.

Required: query Optional: page_size, page_token, order_by

{"action":"search_spaces","query":"display_name:\"Launch\"","order_by":"relevance DESC"}

`find_direct_message`

Finds the direct message space with a user.

Required: user_name

{"action":"find_direct_message","user_name":"users/123456789"}

`list_messages`

Lists messages in a space. Defaults to newest first.

Required: space Optional: page_size, page_token, filter, order_by, show_deleted

{"action":"list_messages","space":"spaces/AAA","page_size":20}

{
  "action": "list_messages",
  "space": "spaces/AAA",
  "filter": "create_time > \"2026-01-01T00:00:00Z\"",
  "order_by": "create_time ASC"
}

`get_message`

Gets a message by resource name or by short message ID with space.

Required: message_name Optional: space

{"action":"get_message","message_name":"spaces/AAA/messages/BBB"}

`search_messages`

Bounded client-side search within one space.

Required: space, query Optional: filter, order_by, show_deleted, page_size, max_results, scan_limit, case_sensitive, search_fields

{"action":"search_messages","space":"spaces/AAA","query":"invoice","max_results":10,"scan_limit":500}

{
  "action": "search_messages",
  "space": "spaces/AAA",
  "query": "Taylor",
  "search_fields": ["sender"],
  "order_by": "create_time DESC"
}

`create_message`

Sends a new message to a space. At least one of text, cards_v2, or file_ids is required.

Required: space, plus one content field Optional: thread_name, thread_key, message_reply_option, message_request_id, message_id, notification_type, file_ids, max_upload_bytes

{"action":"create_message","space":"spaces/AAA","text":"Hello from the agent."}

{
  "action": "create_message",
  "space": "spaces/AAA",
  "text": "Here is the file.",
  "file_ids": ["file-manager-id-1"]
}

`reply_message`

Replies in the original message's thread. At least one of text, cards_v2, or file_ids is required.

Required: message_name, plus one content field Optional: space, message_reply_option, message_request_id, message_id, notification_type, file_ids, max_upload_bytes

{"action":"reply_message","message_name":"spaces/AAA/messages/BBB","text":"Got it."}

{
  "action": "reply_message",
  "message_name": "spaces/AAA/messages/BBB",
  "text": "Attached.",
  "file_ids": ["file-manager-id-1"]
}

`update_message`

Edits an existing message. Only text and cards_v2 updates are exposed.

Required: message_name, plus one of text or cards_v2 Optional: space

{"action":"update_message","message_name":"spaces/AAA/messages/BBB","text":"Updated text"}

`delete_message`

Deletes a message.

Required: message_name Optional: space, force

{"action":"delete_message","message_name":"spaces/AAA/messages/BBB"}

{"action":"delete_message","message_name":"spaces/AAA/messages/BBB","force":true}

`list_reactions`

Lists reactions on a message. page_size must be 200 or less.

Required: message_name Optional: space, page_size, page_token, filter

{"action":"list_reactions","message_name":"spaces/AAA/messages/BBB"}

{"action":"list_reactions","message_name":"spaces/AAA/messages/BBB","filter":"emoji.unicode = \"\\uD83D\\uDE42\""}

`add_reaction`

Adds an emoji reaction to a message.

Required: message_name, emoji_unicode Optional: space

{"action":"add_reaction","message_name":"spaces/AAA/messages/BBB","emoji_unicode":"\\uD83D\\uDC4D"}

`delete_reaction`

Deletes a reaction.

Required: reaction_name Optional: message_name, space

{"action":"delete_reaction","reaction_name":"spaces/AAA/messages/BBB/reactions/RRR"}

`list_message_attachments`

Lists attachments in a message.

Required: message_name Optional: space

{"action":"list_message_attachments","message_name":"spaces/AAA/messages/BBB"}

`get_attachment`

Gets attachment metadata from the parent message payload.

Required: attachment_name Optional: message_name, space

{
  "action": "get_attachment",
  "message_name": "spaces/AAA/messages/BBB",
  "attachment_name": "report.pdf"
}

{"action":"get_attachment","attachment_name":"spaces/AAA/messages/BBB/attachments/ATT"}

`search_attachments`

Bounded client-side attachment search within one space.

Required: space, query Optional: filter, order_by, page_size, max_results, scan_limit, case_sensitive

{"action":"search_attachments","space":"spaces/AAA","query":"report","max_results":10}

`upload_attachment`

Uploads a File Manager file into Chat and returns an attachment_data_ref. Most workflows should use create_message or reply_message with file_ids instead.

Required: space, source_file_id Optional: filename, content_type, max_upload_bytes

{"action":"upload_attachment","space":"spaces/AAA","source_file_id":"file-manager-id-1"}

`download_attachment_to_storage`

Downloads a Chat attachment into AgentPMT File Manager.

Required: media_resource_name or attachment_name Optional: message_name, space, output_filename, expiration_days, max_bytes

{
  "action": "download_attachment_to_storage",
  "message_name": "spaces/AAA/messages/BBB",
  "attachment_name": "report.pdf",
  "output_filename": "report.pdf"
}

{
  "action": "download_attachment_to_storage",
  "media_resource_name": "spaces/AAA/messages/BBB/attachments/ATT/media",
  "output_filename": "report.pdf"
}

Response

All successful responses return {"success": true, "output": { ... }} from the tool route. Output varies by action:

list_spaces -> {"spaces": [...], "next_page_token": "..."}
get_space -> {"space": {...}}
search_spaces -> {"spaces": [...], "next_page_token": "...", "query": "..."}
find_direct_message -> {"space": {...}, "user_name": "..."}
list_messages -> {"messages": [...], "next_page_token": "...", "order_by": "create_time DESC"}
get_message -> {"message": {...}}
search_messages -> {"messages": [...], "matched_count": 0, "scanned_count": 0, "scan_limit_reached": false}
create_message / reply_message -> {"message": {...}, "uploaded_attachments": [...]}
update_message -> {"message": {...}}
delete_message / delete_reaction -> {"deleted": true, "name": "..."}
list_reactions -> {"reactions": [...], "next_page_token": "..."}
add_reaction -> {"reaction": {...}}
list_message_attachments -> {"attachments": [...], "count": 0}
get_attachment -> {"attachment": {...}, "message_name": "..."}
search_attachments -> {"attachments": [...], "matched_count": 0, "scanned_messages": 0}
upload_attachment -> {"attachment_data_ref": {...}, "source_file": {...}}
download_attachment_to_storage -> {"attachment": {...}, "download": {"stored_as": {...}, "content_type": "...", "size_bytes": 0}}

Resource Name Formats

Space: spaces/AAA
Message: spaces/AAA/messages/BBB
Thread: spaces/AAA/threads/CCC
Reaction: spaces/AAA/messages/BBB/reactions/RRR
Attachment: spaces/AAA/messages/BBB/attachments/ATT
User: users/123

Short IDs are accepted only when paired with the parent resource (space or message_name).

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get_instructions' so you know how to use the tool search interface. Then call action 'get_schema' with tool_id 6968000436a6023a803ab753 ("Google Chat"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Google Chat

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Dynamic MCP Setup

30 Second Setup

Hosted Streamable HTTPS

Config Example

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Looking for help integrating AI into your business? Set up a free consultation.