list_space_events
List Space Events
List events from a Google Chat space, or provide eventId to retrieve one specific space event.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Google Chat is where Workspace teams talk. The integration lets an agent post updates to spaces, search conversations for context and manage spaces and members, either as a person or as a Chat app.
Send deploy notes, incident updates or daily summaries into the right space.
Search messages across spaces to find where something was agreed and link back to it.
Create a project space, add the right members and share files as attachments.
Find the direct message with a colleague and send a follow-up on their behalf.
Chat offers Google OAuth, which acts as the signed-in person, and a Chat app service account, which posts as the app. Admin space search needs a Workspace administrator. Chat app access also has to be configured in your Google Cloud project.
Sign-in options on Metorial: Google OAuth, Google Chat App Service Account.
list_space_events
List events from a Google Chat space, or provide eventId to retrieve one specific space event.
manage_reaction
Create Unicode emoji reactions, or list and delete emoji reactions on Google Chat messages.
upload_attachment
Upload base64-encoded file bytes to a Google Chat space and return the attachment data reference needed to include it in a message.
send_message
Send a Markdown-formatted text message to a Google Chat conversation. Optionally reply to an existing thread by resource name or start or reply to an application-owned thread using a thread key.
download_attachment
Download an uploaded Google Chat attachment as a downloadable file.
get_attachment
Get metadata for a Google Chat message attachment. File bytes are retrieved separately with download_attachment.
manage_space
Create, set up, get, update, or delete a Google Chat space. Setup can create a named space, group chat, or direct message with initial members.
find_direct_message
Find the existing Google Chat direct-message space between the specified user and the authenticated user or calling Chat app.
manage_message
Get, update, or delete a Google Chat message. Updates use messages.patch with an explicit text update mask, so only the plain text body can be changed.
search_conversations
List Google Chat conversations the caller can access, optionally filtering the API page by conversation type and matching display names or resource names case-insensitively.
list_messages
List messages from a Google Chat conversation with optional thread and time filters, reverse-chronological ordering, and page-token pagination.
search_messages
Search messages across Google Chat using the messages.search API, including keyword and provider-supported message filters. When the search API is unavailable for the account or project (HTTP 403/404), the tool falls back to spaces.messages.list on one conversation with client-side keyword matching.
manage_section
Create, rename, reorder, or delete custom sections in the signed-in user's Google Chat sidebar.
list_sections
List the signed-in user's Google Chat sidebar sections, including custom sections and the default Direct messages, Spaces, and Apps sections.
update_space_read_state
Mark a Google Chat space as read or unread for the signed-in user by moving their last-read time. Set markAsRead to true to mark everything read, or pass lastReadTime to mark later messages unread.
search_spaces_admin
Search every named Google Chat space in the organization with Google Workspace administrator privileges, using the Chat admin space search syntax. Returns spaces the administrator isn't a member of.
get_space_notification_setting
Get the signed-in user's notification and mute settings for a Google Chat space.
list_custom_emojis
List the custom emoji visible to the signed-in user in their Google Workspace organization's Google Chat.
get_space_read_state
Get the signed-in user's read position in a Google Chat space: the last time they read the space's top-level conversation. Messages created after lastReadTime are unread.
update_space_notification_setting
Change the signed-in user's notification level or mute state for a Google Chat space.
manage_custom_emoji
Create a Google Chat custom emoji from an image, or delete one, in the signed-in user's Google Workspace organization.
get_thread_read_state
Get the signed-in user's read position in a Google Chat thread: the last time they read replies in that thread. Replies created after lastReadTime are unread.
get_custom_emoji
Get one Google Chat custom emoji by resource name or :shortcode:, including a temporary image URL.
list_section_items
List the conversations (spaces) in one of the signed-in user's Google Chat sidebar sections, or find which section holds a given space.
move_section_item
Move a conversation (section item) to a different section in the signed-in user's Google Chat sidebar.
list_members
List the members of a Google Chat space, with optional role and member-type filters, Google Group and invited memberships, and page-token pagination.
manage_membership
Get, add, update the role of, or remove a member of a Google Chat space. Members can be users (by ID or email) or, in named spaces, Google Groups.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Connect Google Chat for authenticated space, membership, message, reaction, attachment, space-event, read-state, notification-setting, sidebar-section, custom-emoji, and admin space search workflows.
Common questions about connecting Google Chat to AI agents with Metorial.