📘
Personal credentials required
The Gmail tool interacts with Gmail using each user's account, adapting to individual access permissions.

Admin: Setup in Dust

Navigate to Spaces > Tools in your Dust workspace, click Add Tools, and select Gmail.

The setup redirects you to an OAuth flow to connect an admin Gmail account. Dust uses the admin account only during setup. Users cannot query Gmail from the admin account.

The Gmail tool is added to the Company data Space, making it accessible across the entire workspace.

Usage

In the @Agent Builder, click Add Tool and select Gmail.

When users first use an agent with the Gmail tool, a connection error appears:

Click the Connect button.

⚠️ Note: Gmail tools with High or Medium stake levels require user approval. See the "Tool Control & Automation" section below for more information on managing approvals.

List of tools

The Gmail tool provides the following capabilities:

Tool	Description	Stake Level
`get_messages`	Retrieves messages from Gmail inbox with support for Gmail search queries	Never ask
`get_attachment`	Retrieves the content of a specific attachment from a Gmail message	Never ask
`get_drafts`	Retrieves all drafts from Gmail	Never ask
`create_draft`	Creates a new email draft in Gmail	Medium
`create_reply_draft`	Creates a reply draft to an existing email thread in Gmail	Medium
`delete_draft`	Deletes a draft email from Gmail	Low
`send_mail`	Sends an email directly from Gmail (new)	High*

⚠️ Note:send_mail is disabled by default on existing workspaces. Admins must manually enable it in Spaces > Tools > Gmail. It is enabled by default on new Gmail tool installations.

Tool Control & Automation

Gmail tools use specific approval levels ("stakes") to control automation:

High stake (e.g., send_mail): Requires explicit user approval every time the tool is used
Medium stake (e.g., create_draft, create_reply_draft): Requires approval once per agent + recipient combination. Once approved, the agent can repeat the action without interruption for that specific combination
Low stake (e.g., delete_draft): Users can disable confirmations
Never ask (e.g., get_messages, get_drafts): Executes automatically without confirmation

Admins can modify the stake level of each tool in Spaces > Tools > Gmail to match their team's workflows and risk tolerance.

Learn more about tool management and stake levels in the Tools Management documentation.

⚠️ Email Reputation Warning: Dust is not designed for bulk email campaigns. Using it for mass outreach can harm your domain's email reputation, affecting deliverability across your entire organization. Keep automation targeted and workflow-driven for best results.