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

# Gmail

> Connect your own mailbox so your agent can search, read, draft, and send email for you

Connect Gmail and your agent becomes genuinely useful with email: it finds the message you half-remember, summarizes long threads, drafts the reply you've been postponing, and — only with your approval — sends it.

Gmail is an **individual** connection: you connect *your* mailbox, and the agent uses it only when *you* are the one talking to it. A colleague asking the same agent gets their own mailbox (if they've connected it), never yours. Admins can't access it either.

## What agents can do

| Capability                | Details                                                                                               |
| ------------------------- | ----------------------------------------------------------------------------------------------------- |
| Search and list mail      | Full Gmail search syntax: sender, date, attachments, labels, free text.                               |
| Read messages and threads | Complete bodies and attachment lists, whole conversations in order.                                   |
| Create drafts             | Prepared in your Drafts folder — nothing is sent until a send action runs or you press send yourself. |
| Send and reply            | New mail or replies in-thread, with attachments.                                                      |
| Organize                  | Archive, star, mark read/unread, apply your labels.                                                   |
| Look up contacts          | Resolve "Maria" to the right address from the people you actually email.                              |

**What it can never do:** permanently delete your mail. Leme deliberately doesn't request that permission from Google — it doesn't exist in the connection at all.

## Try asking

* *"Find the email from the accountant about the Q2 filing — what did she need from me?"*
* *"Summarize my unread messages and tell me which ones actually need a reply."*
* *"Catch me up on the thread with Acme about the renewal."*
* *"Draft a polite reply saying we'll have the numbers by Friday."* — lands in your drafts for review.
* *"Reply to Marcos confirming Tuesday at 10am."* — sent after you approve.
* *"Archive everything from newsletters older than a week."* — applied per your Write permission.

## Connect your Gmail

<Steps>
  <Step title="Open Integrations">
    In the Leme dashboard, go to **Integrations** and select **Gmail**.
  </Step>

  <Step title="Sign in with Google">
    Select **Connect** and approve on Google's consent screen with the account you want the agent to use. Review the requested access — mail and read-only contacts.
  </Step>

  <Step title="Check the agent">
    An admin enables the Gmail integration on the agent; each teammate who wants email help connects their own account the same way.
  </Step>
</Steps>

<Note>
  On some Google Workspace domains, an administrator must allow the Leme app before employees can grant it access. If the consent screen blocks you, that's the place to look.
</Note>

## Permissions

| Action                              | Category               | Default      |
| ----------------------------------- | ---------------------- | ------------ |
| Search, read mail and contacts      | Read                   | Allow        |
| Create drafts, organize with labels | Write                  | Ask approval |
| Send mail, reply                    | External communication | Ask approval |

A useful pattern: keep **sending** behind approval but allow **drafts**. The agent then prepares complete replies in your Drafts folder, and you review and hit send in Gmail — full email help, zero risk of something going out unreviewed. Adjust in **Integrations → Gmail → Agent permissions** — see [Permissions & approvals](/permissions).

<Note>
  If your agent lives in an [email channel](/channels), replying within the conversation it was called in is treated as a normal reply, not as new outbound mail.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The agent says I haven't connected email">
    Individual connections are per person. Even if a colleague connected theirs, you need to connect your own from **Integrations → Gmail**.
  </Accordion>

  <Accordion title="The consent screen shows a warning or blocks the app">
    Your Google Workspace admin controls which apps may access company mail. Ask them to allow Leme for the domain.
  </Accordion>

  <Accordion title="The connection stopped working">
    Google authorizations can be revoked — by you (myaccount.google.com → Security → Third-party access), by an admin, or by a password reset on some account types. Reconnect from **Integrations → Gmail**.
  </Accordion>

  <Accordion title="The agent can't find an email I know exists">
    Try giving it a stronger anchor: sender, an exact phrase, or a date range. The agent searches with Gmail's own syntax, so anything Gmail's search box can find, it can find.
  </Accordion>
</AccordionGroup>