# Google Chat

## Links

- Product page URL: https://www.agentpmt.com/marketplace/google-chat
- Product markdown URL: https://www.agentpmt.com/marketplace/google-chat?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/google-chat?format=agent-json

## Overview

- Product ID: 6968000436a6023a803ab753
- Vendor: Apoth3osis
- Type: connector
- Unit type: request
- Price: 500 credits
- Categories: Task Planning & Orchestration, Project Management, Automation, Team Collaboration & Workspaces, Task & Workflow Automation
- Generated at: 2026-04-15T18:26:49.183Z

### Page Description

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.

### Agent Description

Post to Google Chat spaces, send DMs, read messages. Supports reactions. Actions performed as connected user.

## Details Tab

### 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.

### Actions

- `list_spaces` (5 credits): List all Google Chat spaces the authenticated user has access to.
- `list_members` (5 credits): List members of a specific Google Chat space.
- `list_messages` (5 credits): List messages in a Google Chat space in reverse chronological order (newest first). The filter parameter supports createTime and thread.name only; full-text search is not supported.
- `create_message` (5 credits): Send a new message to a Google Chat space. Optionally post into an existing thread.
- `reply_message` (5 credits): Reply to an existing message in its thread. The thread is resolved automatically from the original message.
- `update_message` (5 credits): Edit an existing message. Only the fields provided (text and/or cards_v2) will be updated.
- `delete_message` (5 credits): Delete a message from a Google Chat space.
- `list_reactions` (5 credits): List all emoji reactions on a message.
- `add_reaction` (5 credits): Add an emoji reaction to a message.
- `delete_reaction` (5 credits): Remove a reaction from a message.
- `get_attachment` (5 credits): Retrieve metadata for an attachment on a message.

### Use Cases

Send messages to spaces, Reply in existing threads, List recent messages, Filter message history, Add or remove reactions, Retrieve space memberships, Fetch attachment metadata, Automate team notifications

### Workflows Using This Tool

No public workflows currently reference this product.

### Related Content

No related content is currently linked to this product.

## Advanced Tab

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer.

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

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

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

### Autonomous Agents

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### Schema

#### Credentials

These runtime credentials should be provided under `parameters._credentials` when required.

- Google OAuth (`google_oauth`, oauth_token, required)
  Help: Connect your Google account.
  Connection ID: 69616abea90ed54743f01957

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "list_spaces": {
      "description": "List all Google Chat spaces the authenticated user has access to.",
      "properties": {
        "page_size": {
          "type": "integer",
          "description": "Maximum number of results per page.",
          "required": false,
          "default": 50,
          "minimum": 1,
          "maximum": 1000
        },
        "page_token": {
          "type": "string",
          "description": "Pagination token from a previous response to fetch the next page.",
          "required": false
        },
        "filter": {
          "type": "string",
          "description": "Filter query (e.g., 'spaceType = \"SPACE\"').",
          "required": false
        }
      }
    },
    "list_members": {
      "description": "List members of a specific Google Chat space.",
      "properties": {
        "space": {
          "type": "string",
          "description": "Space name or ID (e.g., 'spaces/AAA' or 'AAA').",
          "required": true
        },
        "page_size": {
          "type": "integer",
          "description": "Maximum number of results per page.",
          "required": false,
          "default": 50,
          "minimum": 1,
          "maximum": 1000
        },
        "page_token": {
          "type": "string",
          "description": "Pagination token from a previous response.",
          "required": false
        },
        "filter": {
          "type": "string",
          "description": "Filter query for members.",
          "required": false
        }
      }
    },
    "list_messages": {
      "description": "List messages in a Google Chat space in reverse chronological order (newest first). The filter parameter supports createTime and thread.name only; full-text search is not supported.",
      "properties": {
        "space": {
          "type": "string",
          "description": "Space name or ID (e.g., 'spaces/AAA' or 'AAA').",
          "required": true
        },
        "page_size": {
          "type": "integer",
          "description": "Maximum number of results per page.",
          "required": false,
          "default": 50,
          "minimum": 1,
          "maximum": 1000
        },
        "page_token": {
          "type": "string",
          "description": "Pagination token from a previous response.",
          "required": false
        },
        "filter": {
          "type": "string",
          "description": "Filter query. Supports createTime and thread.name only (e.g., 'createTime > \"2025-01-01T00:00:00Z\"').",
          "required": false
        }
      }
    },
    "create_message": {
      "description": "Send a new message to a Google Chat space. Optionally post into an existing thread.",
      "properties": {
        "space": {
          "type": "string",
          "description": "Space name or ID (e.g., 'spaces/AAA' or 'AAA').",
          "required": true
        },
        "text": {
          "type": "string",
          "description": "Message text content. Required if cards_v2 is not provided.",
          "required": false
        },
        "cards_v2": {
          "type": "array",
          "description": "Cards v2 payload for rich card messages. Alternative to text.",
          "required": false,
          "items": {
            "type": "object"
          }
        },
        "thread_name": {
          "type": "string",
          "description": "Thread resource name (e.g., 'spaces/AAA/threads/CCC') to post into an existing thread.",
          "required": false
        }
      }
    },
    "reply_message": {
      "description": "Reply to an existing message in its thread. The thread is resolved automatically from the original message.",
      "properties": {
        "message_name": {
          "type": "string",
          "description": "Message resource name or message ID (e.g., 'spaces/AAA/messages/BBB'). The thread is resolved from this message.",
          "required": true
        },
        "space": {
          "type": "string",
          "description": "Space name or ID, needed if message_name is a short ID rather than a full resource name.",
          "required": false
        },
        "text": {
          "type": "string",
          "description": "Reply text content. Required if cards_v2 is not provided.",
          "required": false
        },
        "cards_v2": {
          "type": "array",
          "description": "Cards v2 payload for rich card replies. Alternative to text.",
          "required": false,
          "items": {
            "type": "object"
          }
        }
      }
    },
    "update_message": {
      "description": "Edit an existing message. Only the fields provided (text and/or cards_v2) will be updated.",
      "properties": {
        "message_name": {
          "type": "string",
          "description": "Message resource name or message ID (e.g., 'spaces/AAA/messages/BBB').",
          "required": true
        },
        "space": {
          "type": "string",
          "description": "Space name or ID, needed if message_name is a short ID.",
          "required": false
        },
        "text": {
          "type": "string",
          "description": "Updated message text. Required if cards_v2 is not provided.",
          "required": false
        },
        "cards_v2": {
          "type": "array",
          "description": "Updated cards v2 payload. Alternative to text.",
          "required": false,
          "items": {
            "type": "object"
          }
        }
      }
    },
    "delete_message": {
      "description": "Delete a message from a Google Chat space.",
      "properties": {
        "message_name": {
          "type": "string",
          "description": "Message resource name or message ID (e.g., 'spaces/AAA/messages/BBB').",
          "required": true
        },
        "space": {
          "type": "string",
          "description": "Space name or ID, needed if message_name is a short ID.",
          "required": false
        }
      }
    },
    "list_reactions": {
      "description": "List all emoji reactions on a message.",
      "properties": {
        "message_name": {
          "type": "string",
          "description": "Message resource name or message ID (e.g., 'spaces/AAA/messages/BBB').",
          "required": true
        },
        "space": {
          "type": "string",
          "description": "Space name or ID, needed if message_name is a short ID.",
          "required": false
        },
        "page_size": {
          "type": "integer",
          "description": "Maximum number of results per page.",
          "required": false,
          "default": 50,
          "minimum": 1,
          "maximum": 1000
        },
        "page_token": {
          "type": "string",
          "description": "Pagination token from a previous response.",
          "required": false
        }
      }
    },
    "add_reaction": {
      "description": "Add an emoji reaction to a message.",
      "properties": {
        "message_name": {
          "type": "string",
          "description": "Message resource name or message ID (e.g., 'spaces/AAA/messages/BBB').",
          "required": true
        },
        "space": {
          "type": "string",
          "description": "Space name or ID, needed if message_name is a short ID.",
          "required": false
        },
        "emoji_unicode": {
          "type": "string",
          "description": "Unicode emoji character to react with (e.g., '👍').",
          "required": true
        }
      }
    },
    "delete_reaction": {
      "description": "Remove a reaction from a message.",
      "properties": {
        "reaction_name": {
          "type": "string",
          "description": "Reaction resource name or reaction ID (e.g., 'spaces/AAA/messages/BBB/reactions/RRR').",
          "required": true
        },
        "message_name": {
          "type": "string",
          "description": "Message resource name, needed if reaction_name is a short ID.",
          "required": false
        },
        "space": {
          "type": "string",
          "description": "Space name or ID, needed if both reaction_name and message_name are short IDs.",
          "required": false
        }
      }
    },
    "get_attachment": {
      "description": "Retrieve metadata for an attachment on a message.",
      "properties": {
        "attachment_name": {
          "type": "string",
          "description": "Attachment resource name or attachment ID (e.g., 'spaces/AAA/messages/BBB/attachments/ATT').",
          "required": true
        },
        "message_name": {
          "type": "string",
          "description": "Message resource name, needed if attachment_name is a short ID.",
          "required": false
        },
        "space": {
          "type": "string",
          "description": "Space name or ID, needed if both attachment_name and message_name are short IDs.",
          "required": false
        }
      }
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "Action to perform. Use get_instructions for full details.",
      "required": true,
      "enum": [
        "get_instructions",
        "list_spaces",
        "list_members",
        "list_messages",
        "create_message",
        "reply_message",
        "update_message",
        "delete_message",
        "list_reactions",
        "add_reaction",
        "delete_reaction",
        "get_attachment"
      ],
      "default": "get_instructions"
    },
    "space": {
      "type": "string",
      "description": "Space name or ID (e.g. 'spaces/AAA' or 'AAA'). Required for list_members, list_messages, create_message.",
      "required": false
    },
    "message_name": {
      "type": "string",
      "description": "Message resource name or message ID (e.g. 'spaces/AAA/messages/BBB'). Required for reply_message, update_message, delete_message, list_reactions, add_reaction.",
      "required": false
    },
    "reaction_name": {
      "type": "string",
      "description": "Reaction resource name or reaction ID. Required for delete_reaction.",
      "required": false
    },
    "attachment_name": {
      "type": "string",
      "description": "Attachment resource name or attachment ID. Required for get_attachment.",
      "required": false
    },
    "text": {
      "type": "string",
      "description": "Message text content. Required (or cards_v2) for create_message, reply_message, update_message.",
      "required": false
    },
    "cards_v2": {
      "type": "array",
      "description": "Cards v2 payload. Alternative to text for create_message, reply_message, update_message.",
      "items": {
        "type": "object"
      },
      "required": false
    },
    "thread_name": {
      "type": "string",
      "description": "Thread resource name (e.g. 'spaces/AAA/threads/CCC'). Used only with create_message to post into an existing thread. For reply_message, use message_name instead.",
      "required": false
    },
    "page_size": {
      "type": "integer",
      "description": "Max results per page (1-1000)",
      "default": 50,
      "minimum": 1,
      "maximum": 1000,
      "required": false
    },
    "page_token": {
      "type": "string",
      "description": "Pagination token from a previous response",
      "required": false
    },
    "filter": {
      "type": "string",
      "description": "Filter query for list actions. For list_messages: supports createTime and thread.name only (e.g. 'createTime > \"2025-01-01T00:00:00Z\"'). Text search is not supported.",
      "required": false
    },
    "emoji_unicode": {
      "type": "string",
      "description": "Unicode emoji character (e.g. '👍'). Required for add_reaction.",
      "required": false
    }
  }
}
```

### Usage Instructions

# Google Chat

Send messages, manage spaces, react to messages, and read conversation history in Google Chat.

## Actions

### list_spaces
Lists all Google Chat spaces the authenticated user has access to.

**Required fields:** none

**Optional fields:** `page_size`, `page_token`, `filter`

**Example — list all spaces:**
```json
{"action": "list_spaces"}
```

**Example — filter to group spaces only:**
```json
{"action": "list_spaces", "page_size": 10, "filter": "spaceType = \"SPACE\""}
```

---

### list_members
Lists members of a specific space.

**Required fields:** `space`

**Optional fields:** `page_size`, `page_token`, `filter`

**Example:**
```json
{"action": "list_members", "space": "spaces/AAA"}
```

---

### list_messages
Lists messages in a space in reverse chronological order (newest first).

**Required fields:** `space`

**Optional fields:** `page_size`, `page_token`, `filter`

The `filter` parameter supports `createTime` and `thread.name` only. Full-text search is not supported.

**Example — recent messages:**
```json
{"action": "list_messages", "space": "spaces/AAA", "page_size": 20}
```

**Example — messages after a date:**
```json
{"action": "list_messages", "space": "spaces/AAA", "filter": "createTime > \"2025-01-01T00:00:00Z\""}
```

---

### create_message
Sends a new message to a space. Optionally post into an existing thread.

**Required fields:** `space`, and one of `text` or `cards_v2`

**Optional fields:** `thread_name`

**Example — simple text message:**
```json
{"action": "create_message", "space": "spaces/AAA", "text": "Hello from the agent!"}
```

**Example — post into an existing thread:**
```json
{"action": "create_message", "space": "spaces/AAA", "text": "Continuing this thread", "thread_name": "spaces/AAA/threads/CCC"}
```

---

### reply_message
Replies to an existing message in its thread. The thread is resolved automatically from the original message.

**Required fields:** `message_name`, and one of `text` or `cards_v2`

Use `message_name` (not `thread_name`) to identify the message you are replying to.

**Example:**
```json
{"action": "reply_message", "message_name": "spaces/AAA/messages/BBB", "text": "Got it, thanks!"}
```

---

### update_message
Edits an existing message. Only the fields you provide (`text` and/or `cards_v2`) will be updated.

**Required fields:** `message_name`, and one of `text` or `cards_v2`

**Example:**
```json
{"action": "update_message", "message_name": "spaces/AAA/messages/BBB", "text": "Updated text"}
```

---

### delete_message
Deletes a message.

**Required fields:** `message_name`

**Example:**
```json
{"action": "delete_message", "message_name": "spaces/AAA/messages/BBB"}
```

---

### list_reactions
Lists all emoji reactions on a message.

**Required fields:** `message_name`

**Optional fields:** `page_size`, `page_token`

**Example:**
```json
{"action": "list_reactions", "message_name": "spaces/AAA/messages/BBB"}
```

---

### add_reaction
Adds an emoji reaction to a message.

**Required fields:** `message_name`, `emoji_unicode`

**Example:**
```json
{"action": "add_reaction", "message_name": "spaces/AAA/messages/BBB", "emoji_unicode": "👍"}
```

---

### delete_reaction
Removes a reaction from a message.

**Required fields:** `reaction_name`

When using a short reaction ID instead of a full resource name, also provide `message_name`.

**Example:**
```json
{"action": "delete_reaction", "reaction_name": "spaces/AAA/messages/BBB/reactions/RRR"}
```

---

### get_attachment
Retrieves metadata for an attachment on a message.

**Required fields:** `attachment_name`

When using a short attachment ID instead of a full resource name, also provide `message_name`.

**Example:**
```json
{"action": "get_attachment", "attachment_name": "spaces/AAA/messages/BBB/attachments/ATT"}
```

---

## Common Workflows

**Post a message and react to it:**
1. `create_message` with `space` and `text` — note the returned message name
2. `add_reaction` with the returned `message_name` and `emoji_unicode`

**Monitor a space for recent activity:**
1. `list_messages` with `space` and a `filter` on `createTime`
2. Page through results using `page_token` if needed

**Reply to the latest message in a space:**
1. `list_messages` with `space` and `page_size` of 1 to get the most recent message
2. `reply_message` with the returned `message_name` and your reply `text`

## 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`

Short IDs (e.g., just `BBB`) are accepted when paired with the parent resource (`space` or `message_name`).

## Important Notes

- The `filter` parameter for `list_messages` supports only `createTime` and `thread.name`. Full-text search of message content is not available.
- `reply_message` automatically resolves the thread from the original message — just provide `message_name`.
- To post into an existing thread without replying to a specific message, use `create_message` with `thread_name`.
- `cards_v2` can be used as an alternative to `text` for rich card messages in `create_message`, `reply_message`, and `update_message`.
- Pagination: use `page_size` (1-1000, default 50) and `page_token` from previous responses to page through results.

### About The Developer

- Vendor name: Apoth3osis
- Website: apoth3osis.io

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

This product has no public dependency products.