Gmail connector
Use Gmail from LLMBase Chat to search, read, send, archive, and trash email with OAuth consent.
Updated
The Gmail connector lets Chat Pro users connect one or more Gmail accounts to LLMBase Chat. The model can search and read mail when the account is selected for the current chat or workspace.
Sending email and delete-like actions require your confirmation.
Capabilities
| Action | Behavior |
|---|---|
| Search messages | Finds messages by Gmail query. |
| Read a message | Retrieves message metadata and content snippets. |
| Send email | Sends a plain-text email after confirmation. |
| Archive a message | Removes the INBOX label after confirmation. |
| Trash a message | Moves the message to trash after confirmation. |
The connector does not permanently delete messages.
Connect Gmail
- Open Chat.
- Open Connectors.
- Select Gmail.
- Choose Connect.
- Complete Google consent.
- Return to Chat and select the Gmail account for the current chat or workspace.
You can connect multiple Gmail accounts. Each account is listed separately and can be selected or cleared independently.
Google permissions
The connector requests the minimum Gmail scopes needed for the current feature set:
| Scope | Used for |
|---|---|
gmail.readonly | Searching and reading messages. |
gmail.modify | Archiving and moving messages to trash. |
gmail.send | Sending email after confirmation. |
openid, email, profile | Identifying the connected Google account in the connector modal. |
LLMBase stores OAuth tokens encrypted. Tokens are not returned in API responses or displayed in Chat.
Safe usage
Review generated email text before approving a send action. If the message should be a draft instead of a send, ask the model to write the draft in chat and do not approve the send action.
For cleanup workflows, ask the model to search first. Review the returned messages before approving archive or trash actions.
Common issues
If Google shows an unverified-app warning or blocks consent, the Google OAuth app or workspace policy may still need approval for Gmail scopes.
If the connector stops working after a password change, security event, or admin policy update, reconnect the Gmail account from the connector modal.