Google Chat

Lobu’s Google Chat adapter supports direct messages, space mentions, and interactive workflows. Under the hood, Lobu uses @chat-adapter/gchat with the Google Chat API and Workspace Events.

Coding

online

List open PRs in lobu-ai/lobu12:01

Can't reach github.com — not in the agent's allowed domains. Grant access?12:01

Allow for 1 hour12:01

Added github.com to allowed domains. 3 open PRs in lobu-ai/lobu: • #214 Fix worker memory leak • #219 Telegram adapter retries • #223 Add Bedrock provider12:01

Ops Assistant

online

Summarize my active Linear sprint12:01

I need the `linear` skill to query Linear. It bundles the Linear MCP and handles OAuth via Lobu.12:01

Go ahead12:01

Installed and connected. Sprint "Week 15" (68% done): • 11 merged, 3 in review, 2 todo • Blocked: AUTH-234 (design) • At risk: API-89 (due tomorrow)12:01

Assistant

online

Switch to Claude Sonnet12:01

You can change the model from your settings — opens a scoped page with your current agent config.12:01

Done — set to claude-sonnet-4-612:01

Now running on claude-sonnet-4-6 via OpenRouter. Next messages will use the new model.12:01

Setup

Create a Google Cloud project and enable the Google Chat API and Workspace Events API.
Create a service account with the Chat Bot role, and download the JSON key file.
In the Google Chat API configuration, configure the app:
- Set the App URL to your gateway’s webhook endpoint: https://your-gateway/api/v1/webhooks/{connectionId}
- Enable Interactive features and configure the connection settings.
Run lobu connections add gchat to add the connection (prompts for the service account JSON), or run lobu init to scaffold a new project and pick Google Chat in the wizard.

Configuration

Field	Required	Type	Description
`credentials`	No	`string`	Service account credentials JSON string. Defaults to GOOGLE_CHAT_CREDENTIALS env var.
`useApplicationDefaultCredentials`	No	`boolean`	Use Application Default Credentials (ADC) instead of service account JSON.
`endpointUrl`	No	`string`	HTTP endpoint URL for button click actions. Required for HTTP endpoint apps.
`googleChatProjectNumber`	No	`string`	Google Cloud project number for verifying webhook JWTs. Defaults to GOOGLE_CHAT_PROJECT_NUMBER env var.
`impersonateUser`	No	`string`	User email for domain-wide delegation. Defaults to GOOGLE_CHAT_IMPERSONATE_USER env var.
`pubsubAudience`	No	`string`	Expected audience for Pub/Sub push JWT verification. Defaults to GOOGLE_CHAT_PUBSUB_AUDIENCE env var.
`userName`	No	`string`	Override bot username.

Connection Settings

These settings apply to all platform connections and are passed in the settings object.

Field	Required	Type	Description
`allowFrom`	No	`string[]`	User IDs allowed to interact with this connection. Omit to allow all; empty array blocks all.
`allowGroups`	No	`boolean`	Whether group messages are allowed (default true).
`userConfigScopes`	No	`string[]`	Scopes that end users are allowed to customize. Empty = no restrictions.

Authentication

The adapter supports three authentication modes:

Service account JSON (default) — provide credentials with the JSON key contents.
Application Default Credentials (ADC) — set useApplicationDefaultCredentials: true. Works with GCE, Cloud Run, Workload Identity Federation, or local gcloud auth application-default login.
Custom auth client — for advanced use cases (programmatic only via the SDK).

Features

Direct messages and space @mentions trigger the agent.
Streaming responses with throttled message edits.
Google Chat Cards v2 for interactive elements (buttons, permission grants, configuration).
Workspace Events integration — subscribes to spaces for real-time message delivery.
Pub/Sub support — receive events via Google Cloud Pub/Sub push subscriptions.
Access control — restrict which users or groups can interact.

Typical Use Cases

Internal assistant accessible from Google Workspace.
Workflow automation triggered by team conversations in Google Chat spaces.
Knowledge base bot for organizations using Google Workspace.