Gmail Integration

Give your AVCodex agent the keys to your Gmail. RFP responses, manufacturer support threads, client commissioning sign-offs. The agent reads, searches, sends, replies, and triages without you ever leaving chat.

Connect Gmail to your AVCodex agent so it can search your inbox, read emails, compose new messages, reply to threads, and manage your mailbox through natural conversation.

What the AI Can Do#

Once connected, your agent gains seven tools for full inbox management:

Tool	Description
gmail_list_emails	Search and list emails with Gmail query syntax
gmail_read_email	Read the full content of a specific email
gmail_send_email	Compose and send a new email (with optional attachments)
gmail_reply_to_email	Reply to an email thread with correct headers
gmail_unsubscribe	Automatically unsubscribe from mailing lists and newsletters
gmail_trash_email	Move an email to the trash
gmail_modify_labels	Mark as read/unread, star, archive, or apply labels

Search Capabilities#

The list tool supports Gmail's full search syntax:

from:dealersupport@crestron.com: emails from a specific sender
is:unread: unread emails only
subject:RFP: emails with a specific subject
newer_than:2d: emails from the last 2 days
has:attachment: emails with attachments (spec sheets, AS-builts, BOMs)
label:INBOX: emails in a specific label

Connecting Gmail#

1. Open the Integrations tab

In your agent's builder, navigate to the Build section and select the Integrations tab. Find Gmail in the list of available integrations.

2. Click Connect

Click the Connect button next to Gmail. A Google OAuth popup will appear.

3. Authorize access

Sign in with the Google account whose inbox you want the agent to manage. Grant the requested permissions for reading and sending emails.

> Warning: Gmail integration requests modify and send permissions. The agent can read, send, reply, trash, and label emails. Only connect accounts you trust the agent to manage. (For an integrator's BD inbox, fine. For the CFO's inbox, think twice.)

4. Test it out

Once connected, open the chat preview and try: - "Show me my unread emails" - "Read the latest manufacturer support thread from Biamp" - "Send an email to the client about tomorrow's commissioning window" - "Unsubscribe me from that AV newsletter"

Key Features#

Sending and Replying#

The agent can compose new emails and reply to existing threads:

New emails support To, CC, BCC recipients, plain text or HTML body
Replies automatically set the correct In-Reply-To and References headers to keep the thread intact (vital for ongoing RFP and commissioning threads)
Reply All includes all original recipients
Attachments: files uploaded in the conversation can be attached to outgoing emails (signed-off commissioning checklists, redlined AS-builts)

Unsubscribe#

The unsubscribe tool is a standout feature. When asked to unsubscribe from a newsletter, the agent:

Reads the List-Unsubscribe header from the email
Tries RFC 8058 one-click unsubscribe (POST request) first
Falls back to visiting the unsubscribe URL and submitting confirmation forms
As a last resort, sends an unsubscribe email via the mailto: link
Optionally trashes the email afterward

Label Management#

Use labels to organize emails through conversation:

"Mark that email as read": removes the UNREAD label
"Star the commissioning sign-off from Acme HQ": adds the STARRED label
"Archive all manufacturer marketing emails": removes the INBOX label

Example Use Cases#

Inbox triage: "Summarize my unread emails from today"
RFP follow-up: "Show me emails tagged 'RFP' and draft holding replies for the ones older than 24 hours"
Inbox cleanup: "Unsubscribe me from all manufacturer marketing emails and trash them"
Client follow-ups: "Reply to the client's commissioning question saying we'll have the AS-built by Friday"
Thread search: "Find the email with the Crestron quote attachment from last month"

Billing#

Gmail tool calls use your standard LLM token billing. There is no separate per-call fee. Listing and reading emails consume tokens based on the content length returned. A long manufacturer support thread costs more to read than a one-line client confirmation.

*AVCodex · Your AV expertise. Amplified by AI.*