# Gmail

> Connect Gmail so your agent can search, read, and send emails as part of its workflow.

## What you can do

* Search through emails using Gmail syntax
* Read full email conversations
* Send emails with CC/BCC support
* Look up email threads from URLs

## Connecting Gmail

1. Go to **Integrations > Gmail**
2. Click **Connect with Google**
3. Sign in to your Google account and grant eesel AI access
4. Authorize the requested permissions

### Prerequisites

* A Gmail or Google Workspace account

## Actions

| Action                 | Description                                                                 |
| ---------------------- | --------------------------------------------------------------------------- |
| **Search Emails**      | Search using Gmail syntax (e.g., `from:customer@example.com subject:order`) |
| **Read Email**         | Read the full content of a specific email by ID                             |
| **Send Email**         | Send an email with optional CC and BCC recipients                           |
| **Get Email from URL** | Extract an email thread from a Gmail URL                                    |

## Use cases

**Support workflow:** Your agent can search for previous email conversations with a customer to understand history before responding to a ticket.

**Email-based support:** Use the Send Email action to have your agent respond directly via email.

**Context gathering:** When handling a support ticket, the agent can look up related email threads for additional context.

## Tips

**Use Gmail search syntax.** The Search Emails action supports full Gmail search operators — `from:`, `to:`, `subject:`, `has:attachment`, date ranges, and more.

**Combine with helpdesk.** Gmail works well alongside helpdesk integrations — your agent can check email history while handling tickets.

## Troubleshooting

**Connection expired?**

* Google OAuth tokens can expire. Disconnect and reconnect to refresh.

**Emails not found?**

* Check that the connected Gmail account has access to the emails you're searching for
* Verify your search syntax is correct