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

# How to connect Gmail or Google Workspace

> Connect a Google email account to Eva through Google's secure authorization, without sharing your password, and bring recent messages into the Inbox.

Connect Gmail or Google Workspace to receive and send email from Eva. Authorization happens
directly in Google. Eva never asks for that account's password.

## Requirements

* The owner or administrator role in the Eva workspace
* Access to sign in to the Google account you want to connect
* Permission from your organization to authorize apps, if you use Google Workspace

## Connect the email

<Steps>
  <Step title="Open Members">
    In Eva, go to **Settings → Members**. Find the person who will use the email and select
    **+ Set up** in the **Email** column.
  </Step>

  <Step title="Choose Google">
    Select **Google — Gmail or Google Workspace**.

    <Frame caption="The provider chooser inside Set up email.">
      <img src="https://mintcdn.com/evaai-85079546/UUpYIbZvk2UaACxQ/images/en/channels/email/email-provider-picker-v202608.webp?fit=max&auto=format&n=UUpYIbZvk2UaACxQ&q=85&s=87ab7e850aab47f85c8a11abd008c0a7" alt="Dialog with the Google, Microsoft and Other provider options." width="1120" height="808" data-path="images/en/channels/email/email-provider-picker-v202608.webp" />
    </Frame>
  </Step>

  <Step title="Choose the right account">
    Eva takes you to Google in the same tab. Sign in, check the address shown, and choose the
    account you want to connect.
  </Step>

  <Step title="Authorize Eva">
    Accept the permissions Google shows. Eva uses them to bring in your email and send from that
    same address.
  </Step>

  <Step title="Return to Eva">
    Google sends you back to Eva. The email appears as **Connected** and the first import begins.

    <Frame caption="The Google mailbox card showing Connected.">
      <img src="https://mintcdn.com/evaai-85079546/UUpYIbZvk2UaACxQ/images/en/channels/email/email-google-connected-v202608.webp?fit=max&auto=format&n=UUpYIbZvk2UaACxQ&q=85&s=e34b606ca26b9339ea30f2ac4cc66512" alt="Connected Gmail card with the green Connected badge." width="1020" height="458" data-path="images/en/channels/email/email-google-connected-v202608.webp" />
    </Frame>
  </Step>
</Steps>

<Note>
  Eva initially brings in email from the last 5 days. New messages keep arriving while the import
  finishes.
</Note>

<Tip>
  If you enter a Google address under **Other provider**, Eva recommends going back and using the
  Google button. It is faster and does not need a password.
</Tip>

## How to know it worked

The Google card shows it as connected. Open Email in the Inbox to see recent messages. You can also
send a test reply to an address you control.

If the card shows **Needs attention**, open [Troubleshoot email](/en/channels/troubleshoot-email).

## If Google will not let you continue

<AccordionGroup>
  <Accordion title="Your organization blocks authorization">
    Some businesses only allow apps approved by their Google Workspace administrator. Ask the
    administrator to authorize Eva, then start again.
  </Accordion>

  <Accordion title="You chose the wrong account">
    Return to **Settings → Members → Email**, remove only the incorrect connection, and connect the
    right address with Google.
  </Accordion>

  <Accordion title="Eva loses access later">
    The card may show **Needs attention** and **Eva's access to this email was removed**. Select
    **Reconnect** and authorize Eva again in Google.
  </Accordion>
</AccordionGroup>

## Next steps

<Card title="Understand email health" href="/en/channels/email-health">
  Learn what Eva checks when receiving and sending email.
</Card>

<Card title="Fix an email that stopped working" href="/en/channels/troubleshoot-email">
  Restore access without losing the mailbox configuration.
</Card>