> For the complete documentation index, see [llms.txt](https://docs.darcyiq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.darcyiq.com/build/integration-overview/enterprise/gmail.md). # Gmail (Google) The **Gmail** integration lets Darcy Chat and AI agents work directly with your Google mailbox — finding messages, reading threads, drafting replies, and sending email — all through natural conversation. It's a personal, user-level connection: you sign in to Google and grant DarcyIQ access, and the connection acts on **your** mailbox only. {% hint style="success" %} **Inbox, without the busywork**: Say *"Find the latest email from Acme about the renewal and draft a reply confirming the call,"* and Darcy searches your mailbox, reads the thread, and prepares a draft for you to review. {% endhint %} {% hint style="info" %} **Beta**: Gmail is currently a Beta integration. In **Settings → Integrations** it appears under **Google Workspace** (the same connection also covers Google Calendar). {% endhint %} ## Overview | Capability | Function | Business Impact | | -------------------- | -------------------------------------------- | -------------------------------- | | **Natural Language** | Search and act on email through chat | No switching to your inbox | | **Smart Search** | Use Gmail's full search syntax | Find the right message fast | | **Draft Assistance** | Generate replies and new messages for review | Faster, on-tone responses | | **Send on Request** | Send email only when you explicitly ask | Stay in control of what goes out | | **Agent & Workflow** | Available to AI agents and AI Workflows | Automate email steps end-to-end | ## What You Can Do | Action | Natural Language Example | Result | | -------------- | ----------------------------------------------------------- | -------------------------------- | | **Search** | "Find unread emails from finance in the last week" | A list of matching messages | | **Read** | "Read the latest message from Jane about the proposal" | The message contents, summarized | | **Draft** | "Draft a reply thanking them and proposing Tuesday at 10am" | A saved Gmail draft to review | | **Send** | "Send an email to with the agenda" | The email is sent | | **Send Draft** | "Send that draft now" | The existing draft is delivered | Darcy understands Gmail search filters such as `from:`, `subject:`, `is:unread`, `has:attachment`, `newer_than:7d`, and date ranges — so you can be as specific as you like. {% hint style="info" %} Darcy prefers **drafts** when you ask it to "draft," "write," or "compose." It only sends when you clearly ask it to send, so nothing leaves your mailbox without your say-so. {% endhint %} ## Connecting Gmail Connecting is a one-time OAuth sign-in. DarcyIQ never sees your Google password — authentication happens on Google's own consent screen. {% stepper %} {% step %} **Open Integrations** Go to **User Configuration → Integrations**. {% endstep %} {% step %} **Find Google Workspace** Locate the **Google Workspace** integration (this is where Gmail lives) and click **Connect**. {% endstep %} {% step %} **Sign in to Google** You're redirected to Google's sign-in and consent screen. Choose the account whose mailbox you want to use. {% endstep %} {% step %} **Approve the DarcyIQ connection** Review the requested permissions and accept. You're returned to DarcyIQ with the integration marked **Connected**. {% endstep %} {% endstepper %} To revoke access later, disconnect the integration in DarcyIQ and/or remove DarcyIQ from your Google account's third-party access settings. ## Using Gmail in Chat & Agents Once connected, Gmail is available wherever Darcy can use tools: * **Darcy Chat** — ask Darcy to find, read, draft, or send email in plain language. * **AI Agents** — agents can include email steps as part of a larger task. * **AI Workflows** — automate recurring email actions (for example, drafting follow-ups after a meeting). ## Permissions & Security | Aspect | Detail | | --------------- | ---------------------------------------------------------------------------------- | | **Scope** | Personal (user-level) — the connection only ever touches your own mailbox | | **Auth method** | OAuth — you sign in with Google and approve DarcyIQ; your password is never shared | | **Sending** | Email is sent only when you explicitly request it | | **Revoking** | Disconnect any time from Settings → Integrations or your Google account settings | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.darcyiq.com/build/integration-overview/enterprise/gmail.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.