How to Connect Gmail to an AI Agent, Step by Step

· DoubleX

Quick answer

To connect Gmail to an AI agent, open the Connectors screen in DoubleX Agentes, add Gmail, sign in with Google and choose whether the connection is personal, team or company. Then set which actions the agent may run (read, draft, send), and test it with a simple request.

Connecting Gmail to an AI agent takes a few minutes, but the choices you make along the way matter: whose inbox the agent reaches, and what it is allowed to do there. This guide covers the connection process only, from creating the account to checking the first result.

What is the Gmail connector in DoubleX Agentes?#

The Gmail connector is the link between your Google mailbox and your agents. Once connected, an agent can search and read emails, create drafts, send emails and organize messages with labels or the trash, always within the permissions you set.

A connector is a system linked to the platform so agents can use its tools. In DoubleX Agentes, connectors live on the Connectors screen, and each agent only uses the ones you assign to it. For the full list of connector settings, see the Connectors documentation.

How do you create an account and open the Connectors screen?#

Create a free account (no credit card), then open Connectors from the main menu. The account is where you describe your company, and the Connectors screen is where you add systems like Gmail.

  1. Sign up at DoubleX Agentes. You will be asked for your company's industry, what you want to improve and where your information lives.
  2. Optionally run the diagnostic: a 5 to 10 minute conversation with the product's AI consultant about your routine. The first one is free, and it can turn into a ready-to-test team of agents.
  3. Open the Connectors screen and look for Gmail in the communication category.

The Quickstart walks through the same first steps if you prefer the official reference.

How do you authorize Gmail: personal, team or company connection?#

You authorize Gmail by choosing Gmail on the Connectors screen and signing in with your Google account. You then decide the scope of the connection: personal, team or company.

Connection typeWho can use itBest for
PersonalOnly youYour own inbox, such as your work email
TeamMembers of a teamA shared mailbox used by one area, such as support
CompanyThe whole companyA mailbox every area is meant to use

A personal connection is the safest default for an individual inbox, because it only works for the person who authorized it. Choose team or company only when the mailbox is truly shared.

How do you choose which actions the agent can run?#

For each agent, you choose which systems it uses and, within each system, which actions it may execute. For Gmail, the actions fall into three levels: reading and searching, creating drafts, and sending.

  1. Open the agent on the Agents screen, or create a new one by describing what you need in your own words.
  2. Add the Gmail connector to that agent.
  3. Turn on only the actions it needs. Actions that change data can stay off, leaving the agent read-only.
  4. Keep sending off at first, and let the agent create drafts you review yourself.

Before the agent sends, deletes or changes anything, it asks for your confirmation and shows what it did step by step. Roles (owner, administrator, member) and sharing by person, team or company add another layer of control.

How do you test it with a first request?#

Send a small, low-risk request and check the result. Reading requests are ideal, since they change nothing in your mailbox. Here are a few you can copy:

  • "Show me the five most recent emails from this week that mention an invoice."
  • "Summarize the unread emails from yesterday and list which ones need a reply."
  • "Create a draft reply to the latest email from this client, but do not send it."
  • "Find the email thread about the contract renewal and tell me the last thing that was said."

If the agent answers correctly, widen the permissions step by step. For ready-made routines, see How to Automate Gmail Email Replies with AI Drafts.

How do you review the history on the Tasks screen?#

Open the Tasks screen. Every request to an agent becomes a task with a complete history: the request, each tool the agent used and the result. You can see who asked, what was done and when.

Use it after your first tests to confirm the agent only used the Gmail actions you allowed. If something looks off, adjust the agent's permissions on the Agents screen and test again. When you are ready to go further, Useful Gmail Automations with an AI Agent: 7 Practical Ideas shows what to build next.

Frequently asked questions#

Do I need to know how to code to connect Gmail?#

No. You add the connector on the Connectors screen, sign in with Google and describe what you want in your own words. Developers who want more control can use the REST API, CLI or MCP server.

Can the agent send emails without asking me?#

No. Before sending, deleting or changing anything, the agent asks for your confirmation and shows the steps it took. You can also leave sending turned off so it only creates drafts.

What is the difference between a personal and a company connection?#

A personal connection only works for the person who authorized it, such as your own inbox. A company connection is available across the company, so use it only for shared mailboxes.

Is my email used to train AI models?#

No. Company content is not used to train models, and requests only go to AI providers that do not use what they receive for training. Each company also has its own separate database.

Can I disconnect or limit Gmail later?#

Yes. You control which systems each agent uses and which actions it can run, so you can turn actions off at any time. Every task stays logged on the Tasks screen.

Related guides

More Gmail guides