Can I use Google Chat as a CLI?

Yes. KosmoKrator exposes a Google Chat CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Google Chat through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Google Chat tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Google Chat credentials stored?

Google Chat credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Google Chat MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Google Chat Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Google Chat KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.google_chat.*. Use lua_read_doc("integrations.google-chat") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Google Chat workflow without starting an interactive agent session.

Inline Lua call

kosmo integrations:lua --eval 'dump(app.integrations.google_chat.spaces_setup({}))' --json

Read Lua docs headlessly

kosmo integrations:lua --eval 'print(docs.read("google-chat"))' --json
kosmo integrations:lua --eval 'print(docs.read("google-chat.spaces_setup"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua

local google_chat = app.integrations.google_chat
local result = google_chat.spaces_setup({})

dump(result)

Run the workflow

kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json

Namespace note. integrations:lua exposes app.integrations.google_chat, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.google_chat.default.* or app.integrations.google_chat.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Google Chat, use the narrower mcp:lua command.

MCP Lua command

# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Google Chat

Google Chat tools are exposed under app.integrations.google_chat. This package is generated from Google’s official Chat API v1 Discovery document and exposes 45 REST methods.

Coverage

Source: https://chat.googleapis.com/$discovery/rest?version=v1
Read tools: 21
Write tools: 24
Base URL: https://chat.googleapis.com

Usage Notes

Pass resource names such as spaces/AAAA, spaces/AAAA/messages/BBBB, users/me/spaces/AAAA, or customEmojis/ID exactly as Google Chat documents them. Path parameters named name and parent use reserved expansion, so slash-delimited resource names are preserved. Query parameters can be passed as top-level shortcuts or inside query. Create, update, patch, watch, and move methods accept the official JSON request object inside body.

google_chat_media_upload accepts file_path, optional mime_type, and optional metadata in body. The integration sends a Google multipart upload request with uploadType=multipart.

Tools

google_chat_spaces_setup - POST /v1/spaces:setup
google_chat_spaces_complete_import - POST /v1/{+name}:completeImport
google_chat_spaces_find_group_chats - GET /v1/spaces:findGroupChats
google_chat_spaces_patch - PATCH /v1/{+name}
google_chat_spaces_search - GET /v1/spaces:search
google_chat_spaces_create - POST /v1/spaces
google_chat_spaces_delete - DELETE /v1/{+name}
google_chat_spaces_find_direct_message - GET /v1/spaces:findDirectMessage
google_chat_spaces_list - GET /v1/spaces
google_chat_spaces_get - GET /v1/{+name}
google_chat_spaces_space_events_get - GET /v1/{+name}
google_chat_spaces_space_events_list - GET /v1/{+parent}/spaceEvents
google_chat_spaces_members_create - POST /v1/{+parent}/members
google_chat_spaces_members_patch - PATCH /v1/{+name}
google_chat_spaces_members_get - GET /v1/{+name}
google_chat_spaces_members_delete - DELETE /v1/{+name}
google_chat_spaces_members_list - GET /v1/{+parent}/members
google_chat_spaces_messages_get - GET /v1/{+name}
google_chat_spaces_messages_delete - DELETE /v1/{+name}
google_chat_spaces_messages_list - GET /v1/{+parent}/messages
google_chat_spaces_messages_create - POST /v1/{+parent}/messages
google_chat_spaces_messages_patch - PATCH /v1/{+name}
google_chat_spaces_messages_update - PUT /v1/{+name}
google_chat_spaces_messages_attachments_get - GET /v1/{+name}
google_chat_spaces_messages_reactions_list - GET /v1/{+parent}/reactions
google_chat_spaces_messages_reactions_delete - DELETE /v1/{+name}
google_chat_spaces_messages_reactions_create - POST /v1/{+parent}/reactions
google_chat_custom_emojis_create - POST /v1/customEmojis
google_chat_custom_emojis_get - GET /v1/{+name}
google_chat_custom_emojis_delete - DELETE /v1/{+name}
google_chat_custom_emojis_list - GET /v1/customEmojis
google_chat_media_upload - POST /v1/{+parent}/attachments:upload (media upload)
google_chat_media_download - GET /v1/media/{+resourceName}
google_chat_users_spaces_get_space_read_state - GET /v1/{+name}
google_chat_users_spaces_update_space_read_state - PATCH /v1/{+name}
google_chat_users_spaces_space_notification_setting_get - GET /v1/{+name}
google_chat_users_spaces_space_notification_setting_patch - PATCH /v1/{+name}
google_chat_users_spaces_threads_get_thread_read_state - GET /v1/{+name}
google_chat_users_sections_delete - DELETE /v1/{+name}
google_chat_users_sections_list - GET /v1/{+parent}/sections
google_chat_users_sections_position - POST /v1/{+name}:position
google_chat_users_sections_patch - PATCH /v1/{+name}
google_chat_users_sections_create - POST /v1/{+parent}/sections
google_chat_users_sections_items_list - GET /v1/{+parent}/items
google_chat_users_sections_items_move - POST /v1/{+name}:move

Examples

local spaces = app.integrations.google_chat.google_chat_spaces_list({ pageSize = 10 })

local message = app.integrations.google_chat.google_chat_spaces_messages_create({
  parent = "spaces/AAAAexample",
  body = { text = "Deployment complete" }
})

Responses are decoded Google Chat JSON responses, or { success = true, status = ... } for successful empty responses such as deletes.

Raw agent markdown

# Google Chat

Google Chat tools are exposed under `app.integrations.google_chat`. This package is generated from Google's official Chat API v1 Discovery document and exposes 45 REST methods.

## Coverage

- Source: `https://chat.googleapis.com/$discovery/rest?version=v1`
- Read tools: 21
- Write tools: 24
- Base URL: `https://chat.googleapis.com`

## Usage Notes

Pass resource names such as `spaces/AAAA`, `spaces/AAAA/messages/BBBB`, `users/me/spaces/AAAA`, or `customEmojis/ID` exactly as Google Chat documents them. Path parameters named `name` and `parent` use reserved expansion, so slash-delimited resource names are preserved. Query parameters can be passed as top-level shortcuts or inside `query`. Create, update, patch, watch, and move methods accept the official JSON request object inside `body`.

`google_chat_media_upload` accepts `file_path`, optional `mime_type`, and optional metadata in `body`. The integration sends a Google multipart upload request with `uploadType=multipart`.

## Tools

- `google_chat_spaces_setup` - POST /v1/spaces:setup
- `google_chat_spaces_complete_import` - POST /v1/{+name}:completeImport
- `google_chat_spaces_find_group_chats` - GET /v1/spaces:findGroupChats
- `google_chat_spaces_patch` - PATCH /v1/{+name}
- `google_chat_spaces_search` - GET /v1/spaces:search
- `google_chat_spaces_create` - POST /v1/spaces
- `google_chat_spaces_delete` - DELETE /v1/{+name}
- `google_chat_spaces_find_direct_message` - GET /v1/spaces:findDirectMessage
- `google_chat_spaces_list` - GET /v1/spaces
- `google_chat_spaces_get` - GET /v1/{+name}
- `google_chat_spaces_space_events_get` - GET /v1/{+name}
- `google_chat_spaces_space_events_list` - GET /v1/{+parent}/spaceEvents
- `google_chat_spaces_members_create` - POST /v1/{+parent}/members
- `google_chat_spaces_members_patch` - PATCH /v1/{+name}
- `google_chat_spaces_members_get` - GET /v1/{+name}
- `google_chat_spaces_members_delete` - DELETE /v1/{+name}
- `google_chat_spaces_members_list` - GET /v1/{+parent}/members
- `google_chat_spaces_messages_get` - GET /v1/{+name}
- `google_chat_spaces_messages_delete` - DELETE /v1/{+name}
- `google_chat_spaces_messages_list` - GET /v1/{+parent}/messages
- `google_chat_spaces_messages_create` - POST /v1/{+parent}/messages
- `google_chat_spaces_messages_patch` - PATCH /v1/{+name}
- `google_chat_spaces_messages_update` - PUT /v1/{+name}
- `google_chat_spaces_messages_attachments_get` - GET /v1/{+name}
- `google_chat_spaces_messages_reactions_list` - GET /v1/{+parent}/reactions
- `google_chat_spaces_messages_reactions_delete` - DELETE /v1/{+name}
- `google_chat_spaces_messages_reactions_create` - POST /v1/{+parent}/reactions
- `google_chat_custom_emojis_create` - POST /v1/customEmojis
- `google_chat_custom_emojis_get` - GET /v1/{+name}
- `google_chat_custom_emojis_delete` - DELETE /v1/{+name}
- `google_chat_custom_emojis_list` - GET /v1/customEmojis
- `google_chat_media_upload` - POST /v1/{+parent}/attachments:upload (media upload)
- `google_chat_media_download` - GET /v1/media/{+resourceName}
- `google_chat_users_spaces_get_space_read_state` - GET /v1/{+name}
- `google_chat_users_spaces_update_space_read_state` - PATCH /v1/{+name}
- `google_chat_users_spaces_space_notification_setting_get` - GET /v1/{+name}
- `google_chat_users_spaces_space_notification_setting_patch` - PATCH /v1/{+name}
- `google_chat_users_spaces_threads_get_thread_read_state` - GET /v1/{+name}
- `google_chat_users_sections_delete` - DELETE /v1/{+name}
- `google_chat_users_sections_list` - GET /v1/{+parent}/sections
- `google_chat_users_sections_position` - POST /v1/{+name}:position
- `google_chat_users_sections_patch` - PATCH /v1/{+name}
- `google_chat_users_sections_create` - POST /v1/{+parent}/sections
- `google_chat_users_sections_items_list` - GET /v1/{+parent}/items
- `google_chat_users_sections_items_move` - POST /v1/{+name}:move

## Examples

```lua
local spaces = app.integrations.google_chat.google_chat_spaces_list({ pageSize = 10 })

local message = app.integrations.google_chat.google_chat_spaces_messages_create({
  parent = "spaces/AAAAexample",
  body = { text = "Deployment complete" }
})
```

Responses are decoded Google Chat JSON responses, or `{ success = true, status = ... }` for successful empty responses such as deletes.

Metadata-derived Lua example

local result = app.integrations.google_chat.spaces_setup({})
print(result)

Functions

spaces_setup Write

Spaces Setup (POST /v1/spaces:setup).

Lua path: app.integrations.google_chat.spaces_setup
Full name: google-chat.google_chat_spaces_setup

Parameter	Type	Required	Description
No parameters.

spaces_complete_import Write

Spaces Complete Import (POST /v1/{+name}:completeImport).

Lua path: app.integrations.google_chat.spaces_complete_import
Full name: google-chat.google_chat_spaces_complete_import

Parameter	Type	Required	Description
No parameters.

spaces_find_group Read

Spaces Find Group Chats (GET /v1/spaces:findGroupChats).

Lua path: app.integrations.google_chat.spaces_find_group
Full name: google-chat.google_chat_spaces_find_group_chats

Parameter	Type	Required	Description
No parameters.

spaces_patch Write

Spaces Patch (PATCH /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_patch
Full name: google-chat.google_chat_spaces_patch

Parameter	Type	Required	Description
No parameters.

spaces_search Read

Spaces Search (GET /v1/spaces:search).

Lua path: app.integrations.google_chat.spaces_search
Full name: google-chat.google_chat_spaces_search

Parameter	Type	Required	Description
No parameters.

spaces_create Write

Spaces Create (POST /v1/spaces).

Lua path: app.integrations.google_chat.spaces_create
Full name: google-chat.google_chat_spaces_create

Parameter	Type	Required	Description
No parameters.

spaces_delete Write

Spaces Delete (DELETE /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_delete
Full name: google-chat.google_chat_spaces_delete

Parameter	Type	Required	Description
No parameters.

spaces_find_direct_message Read

Spaces Find Direct Message (GET /v1/spaces:findDirectMessage).

Lua path: app.integrations.google_chat.spaces_find_direct_message
Full name: google-chat.google_chat_spaces_find_direct_message

Parameter	Type	Required	Description
No parameters.

spaces_list Read

Spaces List (GET /v1/spaces).

Lua path: app.integrations.google_chat.spaces_list
Full name: google-chat.google_chat_spaces_list

Parameter	Type	Required	Description
No parameters.

spaces_get Read

Spaces Get (GET /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_get
Full name: google-chat.google_chat_spaces_get

Parameter	Type	Required	Description
No parameters.

spaces_space_events_get Read

Spaces Space Events Get (GET /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_space_events_get
Full name: google-chat.google_chat_spaces_space_events_get

Parameter	Type	Required	Description
No parameters.

spaces_space_events_list Read

Spaces Space Events List (GET /v1/{+parent}/spaceEvents).

Lua path: app.integrations.google_chat.spaces_space_events_list
Full name: google-chat.google_chat_spaces_space_events_list

Parameter	Type	Required	Description
No parameters.

spaces_members_create Write

Spaces Members Create (POST /v1/{+parent}/members).

Lua path: app.integrations.google_chat.spaces_members_create
Full name: google-chat.google_chat_spaces_members_create

Parameter	Type	Required	Description
No parameters.

spaces_members_patch Write

Spaces Members Patch (PATCH /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_members_patch
Full name: google-chat.google_chat_spaces_members_patch

Parameter	Type	Required	Description
No parameters.

spaces_members_get Read

Spaces Members Get (GET /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_members_get
Full name: google-chat.google_chat_spaces_members_get

Parameter	Type	Required	Description
No parameters.

spaces_members_delete Write

Spaces Members Delete (DELETE /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_members_delete
Full name: google-chat.google_chat_spaces_members_delete

Parameter	Type	Required	Description
No parameters.

spaces_members_list Read

Spaces Members List (GET /v1/{+parent}/members).

Lua path: app.integrations.google_chat.spaces_members_list
Full name: google-chat.google_chat_spaces_members_list

Parameter	Type	Required	Description
No parameters.

spaces_messages_get Read

Spaces Messages Get (GET /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_messages_get
Full name: google-chat.google_chat_spaces_messages_get

Parameter	Type	Required	Description
No parameters.

spaces_messages_delete Write

Spaces Messages Delete (DELETE /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_messages_delete
Full name: google-chat.google_chat_spaces_messages_delete

Parameter	Type	Required	Description
No parameters.

spaces_messages_list Read

Spaces Messages List (GET /v1/{+parent}/messages).

Lua path: app.integrations.google_chat.spaces_messages_list
Full name: google-chat.google_chat_spaces_messages_list

Parameter	Type	Required	Description
No parameters.

spaces_messages_create Write

Spaces Messages Create (POST /v1/{+parent}/messages).

Lua path: app.integrations.google_chat.spaces_messages_create
Full name: google-chat.google_chat_spaces_messages_create

Parameter	Type	Required	Description
No parameters.

spaces_messages_patch Write

Spaces Messages Patch (PATCH /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_messages_patch
Full name: google-chat.google_chat_spaces_messages_patch

Parameter	Type	Required	Description
No parameters.

spaces_messages_update Write

Spaces Messages Update (PUT /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_messages_update
Full name: google-chat.google_chat_spaces_messages_update

Parameter	Type	Required	Description
No parameters.

spaces_messages_attachments_get Read

Spaces Messages Attachments Get (GET /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_messages_attachments_get
Full name: google-chat.google_chat_spaces_messages_attachments_get

Parameter	Type	Required	Description
No parameters.

spaces_messages_reactions_list Read

Spaces Messages Reactions List (GET /v1/{+parent}/reactions).

Lua path: app.integrations.google_chat.spaces_messages_reactions_list
Full name: google-chat.google_chat_spaces_messages_reactions_list

Parameter	Type	Required	Description
No parameters.

spaces_messages_reactions_delete Write

Spaces Messages Reactions Delete (DELETE /v1/{+name}).

Lua path: app.integrations.google_chat.spaces_messages_reactions_delete
Full name: google-chat.google_chat_spaces_messages_reactions_delete

Parameter	Type	Required	Description
No parameters.

spaces_messages_reactions_create Write

Spaces Messages Reactions Create (POST /v1/{+parent}/reactions).

Lua path: app.integrations.google_chat.spaces_messages_reactions_create
Full name: google-chat.google_chat_spaces_messages_reactions_create

Parameter	Type	Required	Description
No parameters.

custom_emojis_create Write

Custom Emojis Create (POST /v1/customEmojis).

Lua path: app.integrations.google_chat.custom_emojis_create
Full name: google-chat.google_chat_custom_emojis_create

Parameter	Type	Required	Description
No parameters.

custom_emojis_get Read

Custom Emojis Get (GET /v1/{+name}).

Lua path: app.integrations.google_chat.custom_emojis_get
Full name: google-chat.google_chat_custom_emojis_get

Parameter	Type	Required	Description
No parameters.

custom_emojis_delete Write

Custom Emojis Delete (DELETE /v1/{+name}).

Lua path: app.integrations.google_chat.custom_emojis_delete
Full name: google-chat.google_chat_custom_emojis_delete

Parameter	Type	Required	Description
No parameters.

custom_emojis_list Read

Custom Emojis List (GET /v1/customEmojis).

Lua path: app.integrations.google_chat.custom_emojis_list
Full name: google-chat.google_chat_custom_emojis_list

Parameter	Type	Required	Description
No parameters.

media_upload Write

Media Upload (POST /v1/{+parent}/attachments:upload).

Lua path: app.integrations.google_chat.media_upload
Full name: google-chat.google_chat_media_upload

Parameter	Type	Required	Description
No parameters.

media_download Read

Media Download (GET /v1/media/{+resourceName}).

Lua path: app.integrations.google_chat.media_download
Full name: google-chat.google_chat_media_download

Parameter	Type	Required	Description
No parameters.

users_spaces_get_space_read_state Read

Users Spaces Get Space Read State (GET /v1/{+name}).

Lua path: app.integrations.google_chat.users_spaces_get_space_read_state
Full name: google-chat.google_chat_users_spaces_get_space_read_state

Parameter	Type	Required	Description
No parameters.

users_spaces_update_space_read_state Write

Users Spaces Update Space Read State (PATCH /v1/{+name}).

Lua path: app.integrations.google_chat.users_spaces_update_space_read_state
Full name: google-chat.google_chat_users_spaces_update_space_read_state

Parameter	Type	Required	Description
No parameters.

users_spaces_space_notification_setting_get Read

Users Spaces Space Notification Setting Get (GET /v1/{+name}).

Lua path: app.integrations.google_chat.users_spaces_space_notification_setting_get
Full name: google-chat.google_chat_users_spaces_space_notification_setting_get

Parameter	Type	Required	Description
No parameters.

users_spaces_space_notification_setting_patch Write

Users Spaces Space Notification Setting Patch (PATCH /v1/{+name}).

Lua path: app.integrations.google_chat.users_spaces_space_notification_setting_patch
Full name: google-chat.google_chat_users_spaces_space_notification_setting_patch

Parameter	Type	Required	Description
No parameters.

users_spaces_threads_get_thread_read_state Read

Users Spaces Threads Get Thread Read State (GET /v1/{+name}).

Lua path: app.integrations.google_chat.users_spaces_threads_get_thread_read_state
Full name: google-chat.google_chat_users_spaces_threads_get_thread_read_state

Parameter	Type	Required	Description
No parameters.

users_sections_delete Write

Users Sections Delete (DELETE /v1/{+name}).

Lua path: app.integrations.google_chat.users_sections_delete
Full name: google-chat.google_chat_users_sections_delete

Parameter	Type	Required	Description
No parameters.

users_sections_list Read

Users Sections List (GET /v1/{+parent}/sections).

Lua path: app.integrations.google_chat.users_sections_list
Full name: google-chat.google_chat_users_sections_list

Parameter	Type	Required	Description
No parameters.

users_sections_position Write

Users Sections Position (POST /v1/{+name}:position).

Lua path: app.integrations.google_chat.users_sections_position
Full name: google-chat.google_chat_users_sections_position

Parameter	Type	Required	Description
No parameters.

users_sections_patch Write

Users Sections Patch (PATCH /v1/{+name}).

Lua path: app.integrations.google_chat.users_sections_patch
Full name: google-chat.google_chat_users_sections_patch

Parameter	Type	Required	Description
No parameters.

users_sections_create Write

Users Sections Create (POST /v1/{+parent}/sections).

Lua path: app.integrations.google_chat.users_sections_create
Full name: google-chat.google_chat_users_sections_create

Parameter	Type	Required	Description
No parameters.

users_sections_items_list Read

Users Sections Items List (GET /v1/{+parent}/items).

Lua path: app.integrations.google_chat.users_sections_items_list
Full name: google-chat.google_chat_users_sections_items_list

Parameter	Type	Required	Description
No parameters.

users_sections_items_move Write

Users Sections Items Move (POST /v1/{+name}:move).

Lua path: app.integrations.google_chat.users_sections_items_move
Full name: google-chat.google_chat_users_sections_items_move

Parameter	Type	Required	Description
No parameters.