[Feature Request] Integrate Gmail Tool #3189
Description
Required prerequisites
- I have searched the Issue Tracker and Discussions that this hasn't already been reported. (+1 or comment there if it has.)
- Consider asking first in a Discussion.
Motivation
Please integrate the Gmail tool into CAMEL, including both actions ( function_call) and triggers.
Each trigger must define clearly whether it is supported via Polling or Webhook.
Solution
Functional Reference
Tool-call:
- Send Email 【P0】
- Reply to Email / Reply to Email Thread【P0】
- Forward Email
- Create Email Draft【P0】
- Send Draft【P0】
- Fetch Emails (with filters & pagination)【P0】
- Fetch Message by ID / Thread ID
- Modify Email Labels (Add / Remove)
- Move to Trash / Delete Message
- Get Attachment【P0】
- List Threads
- List Drafts
- List Gmail Labels
- Create Label
- Delete Label
- Modify Thread Labels
- Get Profile
- Get Contacts / Search People【P0】
Triggers:
New Email Received (Webhook preferred, Polling fallback)
Triggered when a new email arrives in the mailbox.
New Email Matching Search (Webhook preferred, Polling fallback)【P0】
Triggered when an email matching specified criteria (sender, subject, keywords, labels) is received.
Enables automation like invoice processing, lead routing, or security alerts.
New Conversation Started
Triggered when a completely new conversation (thread) begins.
Useful for tracking customer support requests or new opportunities.
New Labeled Email (Polling)【P0】
Triggered when an email is assigned a specified label (e.g., “Urgent,” “Finance,” “Support”).
Common in enterprise workflows where labeling is automated by filters.
New Attachment Received (Polling)【P0】
Triggered when an incoming email contains one or more attachments.
Enterprise use case: automatically process invoices, hr, contracts, or reports.
Alternatives
Additional context
No response