Skip to main content

​
Overview

The Gmail integration brings your email directly into EnConvo’s AI workspace. With 13 built-in tools, you can search, read, send, draft, organize, and manage emails entirely through natural language — no need to switch to your browser or the Gmail app. Ask your AI assistant to find important emails, draft replies, clean up your inbox, or manage labels, and it handles everything behind the scenes using the Gmail API.

​
Available Tools

EnConvo’s Gmail extension exposes the following tools that the AI can use automatically during conversations:

​
Email Operations

​
Batch Operations

​
Label Management

​
Setting Up Gmail

​
Authentication

EnConvo uses Google OAuth to securely connect to your Gmail account. No passwords are stored locally.
1

Open Gmail Extension Settings

Go to Settings and find the Gmail extension
2

Choose Credential Provider

Select either Enconvo AI Gmail (recommended, pre-configured OAuth) or your own Gmail credentials
3

Authorize Access

Click Sign In and follow the Google OAuth flow to grant EnConvo access to your Gmail
4

Start Using Gmail Tools

The Gmail tools are now available to your AI agent. Ask questions about your email in any conversation
The Enconvo AI Gmail credential option provides a pre-configured OAuth setup so you can get started without creating your own Google API project.

​
Using Your Own Google API Credentials

If you prefer to use your own Google Cloud project:
  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the Gmail API
  4. Create OAuth 2.0 credentials (Desktop application type)
  5. In EnConvo, select the Gmail credential provider and enter your Client ID and Client Secret

​
Using Gmail in Conversations

Once connected, simply talk to your AI assistant about email tasks. The AI automatically selects and uses the appropriate Gmail tools.

​
Example Conversations

Search and summarize:
Draft a reply:
Inbox cleanup:
Label management:
Batch operations:

​
Email Composition Features

When sending or drafting emails, the AI can:
  • Set recipients (To, CC, BCC)
  • Compose both plain text and HTML email bodies
  • Attach files from your Mac
  • Reply to existing email threads (preserving thread context)
  • Use multipart/alternative for emails with both plain text and HTML versions

​
Workflows

Gmail tools integrate with EnConvo’s workflow system. Common workflow patterns:

​
Privacy and Security

EnConvo accesses your Gmail only when you explicitly ask the AI to perform email-related tasks. No emails are read, cached, or processed in the background.
  • OAuth 2.0: Industry-standard authentication — EnConvo never sees your Google password
  • On-demand access: Gmail API calls are made only when the AI uses a Gmail tool during your conversation
  • No background syncing: EnConvo does not maintain a local copy of your emails
  • Revocable access: You can revoke EnConvo’s access at any time from your Google Account permissions
  • Scoped permissions: Only the minimum required Gmail scopes are requested

​
Troubleshooting

Go to Settings -> Gmail and re-authenticate by signing in again. OAuth tokens expire periodically and need to be refreshed.
Make sure the Gmail extension is installed and the credential provider is configured. Gmail tools are automatically available to agent-mode conversations — verify that agent mode is enabled.
Gmail search uses the same query syntax as the Gmail web interface. Try simpler queries first (e.g., from:john) and ensure the emails exist in the authenticated account.
Verify that the file paths are correct and accessible. The AI needs valid absolute file paths on your Mac to attach files.

Apple Mail

Native macOS Mail integration

Agents

AI agents that use Gmail tools automatically

Workflows

Automate email tasks with workflows

Context Awareness

AI understands your current context