Gmail Integration

Connect your Gmail account to send emails, search your inbox, read messages, and manage labels — all from Theo chat.

Why Connect Gmail?

Send emails directly from Theo chat
Search your inbox by keyword, sender, or label
Read and summarize email threads
Manage Gmail labels and organize messages
Ask Theo to draft or reply to emails

Connecting Gmail

Open the connector

Go to Skill Store → Flow Connectors → Gmail and click Connect.

Authorize with Google

You'll be redirected to Google's OAuth consent screen. Grant Gmail access.

Done

Your Gmail is now connected and available in Theo AI Chat.

What You Can Do

  • • Send emails with subject, body, and recipients
  • • Search inbox by keyword, sender, date, or label
  • • Read email content and metadata
  • • List and manage Gmail labels
  • • Reply to and forward emails

Using Gmail from Theo Chat

"Send an email to jane@acme.com about the Q2 report"Composes and sends the email
"Search my inbox for messages from john@co.com"Returns matching emails
"Summarize my unread emails"Reads and summarizes recent unread messages
"Show my Gmail labels"Lists all labels

Token Management

OAuth tokens are automatically refreshed by OpenCharts. If a refresh fails, you'll see a reconnection prompt in the Skill Store.

Disconnecting

Go to Skill Store → Flow Connectors → Gmail and click Disconnect. You can also revoke access from myaccount.google.com → Security → Third-party apps.

Troubleshooting

Can't send emails

Make sure you granted the 'Send email' scope during authorization.

Search returns nothing

Gmail search uses the same syntax as the Gmail search bar. Try simpler queries.

"No credentials found"

Reconnect from Skill Store → Flow Connectors → Gmail.

Was this article helpful?

Related Articles