Before accessing any Gmail tools, connect your Gmail account via the App Connection page. Without this, tool calls will fail due to missing authorization.
Gmail Tool Categories
Email Draft Management
Manage your email drafts for later editing or sending.GMAIL_CREATE_EMAIL_DRAFT– Create and save a new email draft.GMAIL_LIST_DRAFTS– Retrieve a list of all saved drafts.GMAIL_DELETE_DRAFT– Permanently delete a specified draft.GMAIL_SEND_DRAFT– Send an existing draft as an email.
Email Sending & Replying
Send new emails or reply to existing threads.GMAIL_SEND_EMAIL– Compose and send a new email immediately.GMAIL_REPLY_TO_THREAD– Reply to an existing email thread.
Email Fetching & Reading
Fetch and read emails or threads.GMAIL_FETCH_EMAILS– Fetch multiple emails using filters or queries.GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID– Get a single email by its message ID.GMAIL_FETCH_MESSAGE_BY_THREAD_ID– Retrieve all messages in a specific thread.GMAIL_LIST_THREADS– List email conversation threads.
Attachment Handling
Download attachments from your emails.GMAIL_GET_ATTACHMENT– Download attachments from emails.
Contacts & Profiles
Access your contacts and profile information.GMAIL_GET_CONTACTS– List your Gmail contacts.GMAIL_GET_PEOPLE– Fetch detailed information about contacts.GMAIL_SEARCH_PEOPLE– Search contacts by name, email, or other parameters.GMAIL_GET_PROFILE– Get profile information for the connected account.
Email Label Management
Organize emails with labels.GMAIL_LIST_LABELS– List all labels in your account.GMAIL_PATCH_LABEL– Update properties of a label.
Email Organization
Organize or delete your emails.GMAIL_MOVE_TO_TRASH– Move emails to the trash folder.GMAIL_DELETE_MESSAGE– Permanently delete an email.
Usage Notes
- Handle message and thread IDs carefully to avoid errors.
- Use label management tools for powerful email organization.
- Fetching tools let you access email content and metadata for downstream processing or AI analysis.