Gmail Integration

Sidekick's Gmail integration lets the agent connect to your Gmail account to monitor your inbox, read and organise emails, draft replies, and send messages — all in real time.

Overview

Capability	Supported
Read emails & threads	✅
Draft emails	✅
Send emails	✅
Real-time inbox monitoring	✅ (push notifications)
Labels	✅
Threads	✅
Attachments	✅
Smart reply suggestions	✅

Connecting Gmail

1. Open the Integrations section of your Sidekick dashboard.
2. Locate Gmail and click Connect.
3. Complete the Google OAuth flow — grant the permissions requested so Sidekick can read, draft, and send on your behalf.
4. Once authorised, the agent will begin monitoring your inbox immediately.

No API keys, no server configuration, and no local setup required.

Real-Time Inbox Monitoring

Gmail push notifications are used to deliver new email events to your agent in real time. When a new message arrives, the agent is notified instantly and can act on it according to your configured automations — without any polling delay.

Reading & Searching Emails

The agent can:

• Read individual messages and full conversation threads
• Search your inbox using natural-language queries
• Access message metadata (sender, subject, date, labels)
• Read file attachments associated with messages

Drafting & Sending Emails

Depending on your automation settings, the agent can:

• Draft emails for your review before sending
• Send emails autonomously when an automation trigger is met
• Compose replies within existing threads, preserving context

Tip: Start with draft-only mode to review the agent's output before enabling autonomous sending.

Labels

The agent respects and can interact with Gmail labels:

• Read emails filtered by label
• Apply labels to incoming or processed messages
• Use labels as automation conditions (e.g. act on emails tagged urgent)

Thread Handling

Emails are processed at the thread level, not as isolated messages. This means the agent understands conversation history and can generate contextually accurate replies or summaries.

Attachments

The agent can read attachments on incoming emails, enabling it to extract information, summarise documents, or trigger workflows based on attachment content.

Smart Reply Suggestions

For incoming emails, the agent can generate smart reply suggestions — short, contextually relevant responses based on the email content. Suggestions are:

• Generated automatically for new messages matching your configured criteria
• Presented for your review, or sent automatically depending on your settings
• Drafted within the original thread for conversational continuity

Permissions

During the OAuth flow, Google will prompt you to grant the following permission scopes:

Scope	Purpose
gmail.readonly	Read emails and threads
gmail.compose	Draft and send emails
gmail.labels	Read and manage labels
gmail.metadata	Access message metadata

You can revoke access at any time from your Google Account settings or from the Sidekick integrations dashboard.

Troubleshooting

Push notifications not arriving? Ensure the connected Google account has not revoked the required OAuth permissions. Disconnect and reconnect the integration to re-establish the push notification subscription.

Agent not sending emails? Check your automation settings — autonomous sending must be explicitly enabled. By default, the agent will draft emails for your review.

Missing labels or threads? Confirm that the Gmail account being used matches the account you connected during OAuth. Only the connected account's data is accessible.