> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trilo.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Gmail Integration

> Connect Gmail to Trilo and let AI help manage your email

Connect Gmail to Trilo and let AI coworkers help you manage email. They can read messages, search your inbox, draft replies, and send emails on your behalf. This is a personal integration—only you can use your connected Gmail.

## What AI Can Do with Gmail

Once connected, AI coworkers can:

| Capability            | Example Use                                   |
| --------------------- | --------------------------------------------- |
| **Read emails**       | "What emails did I get from clients today?"   |
| **Search inbox**      | "Find the email about the Q4 budget"          |
| **Draft emails**      | "Draft a reply to Sarah's proposal"           |
| **Send emails**       | "Send the follow-up to the meeting attendees" |
| **Summarize threads** | "Summarize the email chain with Acme Corp"    |
| **Find attachments**  | "Find the PDF John sent last week"            |

## Prerequisites

* A Gmail account (or Google Workspace email)
* Access to Trilo's personal integrations settings

## Connecting Gmail

<Steps>
  <Step title="Open Personal Settings">
    Click your avatar in Trilo, then select **Settings**.
  </Step>

  <Step title="Go to Integrations">
    Select the **Integrations** tab.
  </Step>

  <Step title="Find Gmail">
    In the **Personal** integrations section, find **Gmail**.
  </Step>

  <Step title="Click Connect">
    Click the **Connect** button.
  </Step>

  <Step title="Sign in to Google">
    You'll be redirected to Google. Sign in with your Gmail account.
  </Step>

  <Step title="Grant Permissions">
    Review and accept the permissions:

    * Read your email messages
    * Send email on your behalf
    * Manage labels and drafts
  </Step>
</Steps>

<Warning>
  AI can send emails on your behalf. Always review AI-drafted emails before confirming to send.
</Warning>

## Using Gmail with AI Coworkers

Chat with AI in your **direct messages** about email:

### Reading and Searching

```
You: What emails do I have from marketing this week?
AI: You have 5 emails from the marketing team:
  1. Campaign Results - from Sarah (Monday)
  2. Re: Q1 Planning - from Mike (Tuesday)
  ...

You: What did Sarah's email say about the campaign?
AI: Sarah's email summarized the Q4 campaign results:
  - 15% increase in conversions
  - Email open rate at 28%
  - Recommended focusing on...
```

### Drafting Emails

```
You: Draft a reply to Sarah thanking her for the report
AI: Here's a draft reply:

  Subject: Re: Campaign Results

  Hi Sarah,

  Thank you for the detailed campaign report...

  Would you like me to send this or make any changes?

You: Make it more concise and add a question about next quarter
AI: Here's the updated draft:
  ...
```

### Sending Emails

```
You: Send the email
AI: Email sent to Sarah at sarah@company.com.
```

<Info>
  AI will always show you the email content before sending and ask for confirmation.
</Info>

## Privacy and Data

### Your Email is Private

* **Personal integration**: Only you can access your Gmail through Trilo
* **No storage**: Trilo doesn't store your emails; it reads them on-demand
* **Your DMs only**: Gmail access only works in direct messages with AI coworkers
* **Not in projects**: Team members cannot use your Gmail integration

### What AI Can See

When you ask AI about email:

* AI reads relevant messages to answer your question
* AI doesn't proactively scan your entire inbox
* Emails are processed in context of your conversation

## Permissions Explained

| Permission        | Why It's Needed                       |
| ----------------- | ------------------------------------- |
| **Read emails**   | To search and summarize your messages |
| **Send emails**   | To send emails when you confirm       |
| **Manage drafts** | To create and update email drafts     |
| **Manage labels** | To organize emails when requested     |

## Best Practices

<AccordionGroup>
  <Accordion title="Always review before sending">
    AI drafts can be helpful, but always read the email before confirming send. Check tone, accuracy, and that the right recipients are included.
  </Accordion>

  <Accordion title="Use for search and summarization">
    AI is particularly good at finding old emails and summarizing long threads. "Find the contract John sent in September" is a great use case.
  </Accordion>

  <Accordion title="Be specific in requests">
    Instead of "check my email," try "what emails did I get from clients this week?" Specificity helps AI give better results.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="AI says it can't access Gmail">
    Check that:

    1. You're in a **direct message** with AI (not a project chat)
    2. The integration is still connected (Settings → Integrations)
    3. Try disconnecting and reconnecting
  </Accordion>

  <Accordion title="Can't connect - permission denied">
    Your Google account may have restrictions:

    1. Google Workspace admins can disable third-party access
    2. Contact your IT admin if using a work account
    3. Try with a personal Gmail account to test
  </Accordion>

  <Accordion title="Email search returns nothing">
    Be more specific:

    * Include sender name or email
    * Include keywords from the subject or body
    * Specify a date range
  </Accordion>

  <Accordion title="Sent email went to spam">
    This is a recipient issue, not a Trilo issue. The email was sent correctly from your Gmail. The recipient's spam filter caught it.
  </Accordion>
</AccordionGroup>

## Disconnecting Gmail

<Steps>
  <Step title="Go to Settings">
    Click your avatar → **Settings** → **Integrations**.
  </Step>

  <Step title="Find Gmail">
    Locate the Gmail integration.
  </Step>

  <Step title="Click Disconnect">
    Confirm the disconnection.
  </Step>
</Steps>

Also revoke access from [Google Account Permissions](https://myaccount.google.com/permissions).

## Security Considerations

* **OAuth-based**: Uses Google OAuth, not your password
* **Revocable**: Can be disconnected anytime from Trilo or Google
* **No password stored**: Trilo never sees your Gmail password
* **Personal only**: Your email access isn't shared with teammates

## Next Steps

<CardGroup cols={2}>
  <Card title="Google Calendar" icon="calendar" href="/integrations/google-calendar">
    Also connect your calendar.
  </Card>

  <Card title="AI Coworkers" icon="robot" href="/ai-coworkers/overview">
    Learn more about AI capabilities.
  </Card>

  <Card title="All Integrations" icon="plug" href="/settings/integrations">
    See other available integrations.
  </Card>
</CardGroup>