Product
Google Chat
Google Chat spaces, messages and members, plus Workspace Events subscriptions.
Install
gchat is one plugin in the google-services-mcps marketplace, and it runs one MCP server with the same name. Install it for Claude Code with the command below. For Codex, OpenCode or Antigravity, change --agent; the product id stays the same.
Install for Claude Code
npx google-services-mcps install --agent claude --plugin gchatWhat it manages
The server carries 2 generated API bindings and 0 gateway APIs. Gateway APIs are reached through api_search, api_describe and api_call, which every product with gateway APIs lists.
| API | Version |
|---|---|
| chat | v1 |
| workspaceevents | v1 |
Tools
The plugin's server registers 78 tools: 36 reads, 32 writes, 10 destructive actions and 0 dynamic tools. A read never asks. A write is listed only when Allow write tools is on, and asks before it runs. A destructive action asks twice. A dynamic tool decides per call.
Every tool name starts with mcp__plugin_gchat_gchat__, so a call traces back to this product. The table lists the tools this server registers, with the safety class from the plugin's tool map.
| Tool | Class | What it does |
|---|---|---|
| account_remove | write | Remove a signed-in account |
| account_set_default | write | Set the default account |
| accounts_list | read | Signed-in accounts |
| api_methods | read | gchat: API methods |
| auth_login | write | Sign in to Google |
| auth_setup_client | write | Save the Google OAuth client |
| auth_status | read | Sign-in status |
| chat_custom_emojis_create | write | chat.customEmojis.create |
| chat_custom_emojis_delete | destructive | chat.customEmojis.delete |
| chat_custom_emojis_get | read | chat.customEmojis.get |
| chat_custom_emojis_list | read | chat.customEmojis.list |
| chat_get_notification_settings | read | Get Chat notification settings |
| chat_list_members | read | List Chat members |
| chat_list_messages | read | List Chat messages |
| chat_mark_as_do_not_disturb | write | chat.users.availability.markAsDoNotDisturb |
| chat_mark_read | write | Mark Chat conversations read |
| chat_mark_unread | write | Mark a Chat conversation unread |
| chat_media_download | read | chat.media.download |
| chat_search_conversations | read | Find Chat conversations |
| chat_search_messages | read | Search Chat messages |
| chat_send_message | destructive | Send a Chat message |
| chat_spaces_complete_import | write | chat.spaces.completeImport |
| chat_spaces_create | write | chat.spaces.create |
| chat_spaces_delete | destructive | chat.spaces.delete |
| chat_spaces_find_direct_message | read | chat.spaces.findDirectMessage |
| chat_spaces_find_group_chats | read | chat.spaces.findGroupChats |
| chat_spaces_get | read | chat.spaces.get |
| chat_spaces_list | read | chat.spaces.list |
| chat_spaces_members_create | write | chat.spaces.members.create |
| chat_spaces_members_delete | destructive | chat.spaces.members.delete |
| chat_spaces_members_get | read | chat.spaces.members.get |
| chat_spaces_members_list | read | chat.spaces.members.list |
| chat_spaces_members_patch | write | chat.spaces.members.patch |
| chat_spaces_message_pins_create | write | chat.spaces.messagePins.create |
| chat_spaces_message_pins_delete | destructive | chat.spaces.messagePins.delete |
| chat_spaces_message_pins_list | read | chat.spaces.messagePins.list |
| chat_spaces_messages_attachments_get | read | chat.spaces.messages.attachments.get |
| chat_spaces_messages_create | destructive | chat.spaces.messages.create |
| chat_spaces_messages_delete | destructive | chat.spaces.messages.delete |
| chat_spaces_messages_get | read | chat.spaces.messages.get |
| chat_spaces_messages_list | read | chat.spaces.messages.list |
| chat_spaces_messages_patch | write | chat.spaces.messages.patch |
| chat_spaces_messages_reactions_create | write | chat.spaces.messages.reactions.create |
| chat_spaces_messages_reactions_delete | destructive | chat.spaces.messages.reactions.delete |
| chat_spaces_messages_reactions_list | read | chat.spaces.messages.reactions.list |
| chat_spaces_messages_replace_cards | write | chat.spaces.messages.replaceCards |
| chat_spaces_messages_search | read | chat.spaces.messages.search |
| chat_spaces_messages_update | write | chat.spaces.messages.update |
| chat_spaces_patch | write | chat.spaces.patch |
| chat_spaces_search | read | chat.spaces.search |
| chat_spaces_setup | write | chat.spaces.setup |
| chat_spaces_space_events_get | read | chat.spaces.spaceEvents.get |
| chat_spaces_space_events_list | read | chat.spaces.spaceEvents.list |
| chat_spaces_space_notif_setting_get | read | chat.users.spaces.spaceNotificationSetting.get |
| chat_spaces_space_notif_setting_patch | write | chat.users.spaces.spaceNotificationSetting.patch |
| chat_spaces_update_space_read_state | write | chat.users.spaces.updateSpaceReadState |
| chat_threads_get_thread_read_state | read | chat.users.spaces.threads.getThreadReadState |
| chat_update_notification_settings | write | Change Chat notification settings |
| chat_users_availability_get | read | chat.users.availability.get |
| chat_users_availability_mark_as_active | write | chat.users.availability.markAsActive |
| chat_users_availability_mark_as_away | write | chat.users.availability.markAsAway |
| chat_users_availability_patch | write | chat.users.availability.patch |
| chat_users_sections_create | write | chat.users.sections.create |
| chat_users_sections_delete | destructive | chat.users.sections.delete |
| chat_users_sections_items_list | read | chat.users.sections.items.list |
| chat_users_sections_items_move | write | chat.users.sections.items.move |
| chat_users_sections_list | read | chat.users.sections.list |
| chat_users_sections_patch | write | chat.users.sections.patch |
| chat_users_sections_position | write | chat.users.sections.position |
| chat_users_spaces_get_space_read_state | read | chat.users.spaces.getSpaceReadState |
| health | read | Server health |
| workspacee_operations_get | read | workspaceevents.operations.get |
| workspacee_subscriptions_create | write | workspaceevents.subscriptions.create |
| workspacee_subscriptions_delete | destructive | workspaceevents.subscriptions.delete |
| workspacee_subscriptions_get | read | workspaceevents.subscriptions.get |
| workspacee_subscriptions_list | read | workspaceevents.subscriptions.list |
| workspacee_subscriptions_patch | write | workspaceevents.subscriptions.patch |
| workspacee_subscriptions_reactivate | write | workspaceevents.subscriptions.reactivate |
The plugin option toolset can list fewer tools. google lists 9 tools that do the same jobs as Google's official MCP server for this product; curated lists the hand-written and gateway tools; all is the default.
Sign-in
gchat belongs to the workspace-user login group. Log in once for the group: create a Desktop OAuth client in a Google Cloud project, save its file with npx google-services-mcps setup-client, then run npx google-services-mcps login workspace-user. Products in this group share the one login.
The plugin's scope file lists 49 OAuth scopes for 1 APIs. A login asks only for the scopes of its profile: readonly (the default), readwrite, full, or an exact list.
| API | Scope |
|---|---|
| gchat | https://www.googleapis.com/auth/chat.admin.delete |
| gchat | https://www.googleapis.com/auth/chat.admin.memberships |
| gchat | https://www.googleapis.com/auth/chat.admin.memberships.readonly |
| gchat | https://www.googleapis.com/auth/chat.admin.spaces |
| gchat | https://www.googleapis.com/auth/chat.admin.spaces.readonly |
| gchat | https://www.googleapis.com/auth/chat.app.all.memberships.readonly |
| gchat | https://www.googleapis.com/auth/chat.app.all.messages.readonly |
| gchat | https://www.googleapis.com/auth/chat.app.all.spaces.readonly |
| gchat | https://www.googleapis.com/auth/chat.app.all.users.readstate.readonly |
| gchat | https://www.googleapis.com/auth/chat.app.delete |
| gchat | https://www.googleapis.com/auth/chat.app.memberships |
| gchat | https://www.googleapis.com/auth/chat.app.memberships.readonly |
| gchat | https://www.googleapis.com/auth/chat.app.messages.readonly |
| gchat | https://www.googleapis.com/auth/chat.app.spaces |
| gchat | https://www.googleapis.com/auth/chat.app.spaces.create |
| gchat | https://www.googleapis.com/auth/chat.app.spaces.readonly |
| gchat | https://www.googleapis.com/auth/chat.bot |
| gchat | https://www.googleapis.com/auth/chat.customemojis |
| gchat | https://www.googleapis.com/auth/chat.customemojis.readonly |
| gchat | https://www.googleapis.com/auth/chat.delete |
| gchat | https://www.googleapis.com/auth/chat.import |
| gchat | https://www.googleapis.com/auth/chat.memberships |
| gchat | https://www.googleapis.com/auth/chat.memberships.app |
| gchat | https://www.googleapis.com/auth/chat.memberships.readonly |
| gchat | https://www.googleapis.com/auth/chat.messages |
| gchat | https://www.googleapis.com/auth/chat.messages.create |
| gchat | https://www.googleapis.com/auth/chat.messages.reactions |
| gchat | https://www.googleapis.com/auth/chat.messages.reactions.create |
| gchat | https://www.googleapis.com/auth/chat.messages.reactions.readonly |
| gchat | https://www.googleapis.com/auth/chat.messages.readonly |
| gchat | https://www.googleapis.com/auth/chat.spaces |
| gchat | https://www.googleapis.com/auth/chat.spaces.create |
| gchat | https://www.googleapis.com/auth/chat.spaces.pins |
| gchat | https://www.googleapis.com/auth/chat.spaces.pins.readonly |
| gchat | https://www.googleapis.com/auth/chat.spaces.readonly |
| gchat | https://www.googleapis.com/auth/chat.users.availability |
| gchat | https://www.googleapis.com/auth/chat.users.availability.readonly |
| gchat | https://www.googleapis.com/auth/chat.users.readstate |
| gchat | https://www.googleapis.com/auth/chat.users.readstate.readonly |
| gchat | https://www.googleapis.com/auth/chat.users.sections |
| gchat | https://www.googleapis.com/auth/chat.users.sections.readonly |
| gchat | https://www.googleapis.com/auth/chat.users.spacesettings |
| gchat | https://www.googleapis.com/auth/drive |
| gchat | https://www.googleapis.com/auth/drive.file |
| gchat | https://www.googleapis.com/auth/drive.metadata |
| gchat | https://www.googleapis.com/auth/drive.metadata.readonly |
| gchat | https://www.googleapis.com/auth/drive.readonly |
| gchat | https://www.googleapis.com/auth/meetings.space.created |
| gchat | https://www.googleapis.com/auth/meetings.space.readonly |
Plugin details
- Plugin
- gchat
- MCP server
- gchat
- Display name
- Google Chat
- Version
- 2.17.0
- Marketplace
- google-services-mcps
- Login group
- workspace-user
- Marketplace category
- productivity
- Plugin options
- allow_writes, confirmation, token_dir, toolset
- Server kind
- curated+discovery