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

# Gmail

> Connect Gmail to send and receive emails with Duckie

Connect Gmail to let Duckie handle email-based support conversations.

## Capabilities

| Capability             | Supported           |
| ---------------------- | ------------------- |
| **Knowledge Source**   | ✗                   |
| **Deployment Trigger** | ✓ Respond to emails |
| **Tool Actions**       | ✓ Send emails       |

## Setup

### Connect via OAuth

1. Go to **Settings → Connections** in Duckie
2. Find **Gmail** and click **Connect**
3. Sign in with your Google account
4. Grant Duckie permission to read and send emails
5. You'll be redirected back to Duckie

<Info>
  Duckie requests permission to read incoming emails and send replies on your behalf.
</Info>

## Using as a Deployment Trigger

Deploy an agent to handle emails:

1. Go to **Deploy**
2. Click **Create Deployment**
3. Select your agent
4. Choose **Gmail** as the trigger
5. Configure which emails trigger responses:
   * **All emails** — Respond to every incoming email
   * **Specific senders** — Only emails from certain addresses
   * **Labels** — Only emails with specific Gmail labels

### Filter Examples

* Support emails: Filter by label `support` or sender domain
* Customer inquiries: Filter by subject containing "question" or "help"

## Available Tools

| Tool               | Description                 |
| ------------------ | --------------------------- |
| `gmail_send`       | Send an email reply         |
| `gmail_get_thread` | Get full email conversation |
| `gmail_search`     | Search emails               |

## Best Practices

### Use a Dedicated Support Email

Set up a dedicated email like `support@yourcompany.com`:

* Clear separation from personal emails
* Easy to manage and monitor
* Can be shared across team

### Set Up Gmail Filters

Use Gmail filters to organize incoming emails:

* Auto-label support requests
* Skip spam before it reaches Duckie

### Include Thread Context

Duckie automatically reads the email thread for context, so it understands the full conversation history.

## Example Use Cases

### Email Support Inbox

Deploy Duckie to handle your `support@` inbox:

* Answer common questions
* Acknowledge receipt of complex issues
* Route to human agents when needed

### Sales Inquiries

Handle initial sales emails:

* Provide product information
* Answer pricing questions
* Schedule demos

## Troubleshooting

### "Cannot send emails"

* Re-authenticate the Gmail connection
* Verify your Google account is in good standing
* Check that you approved send permissions

### "Not receiving emails"

* Verify the deployment is in Live mode
* Check Gmail filters aren't blocking emails
* Ensure the email address is correctly configured