modify_message
Modify Message
Modify a message's labels, move it to trash, or restore it from trash. Supports both single and batch operations on multiple messages.
modify_message
Modify a message's labels, move it to trash, or restore it from trash. Supports both single and batch operations on multiple messages.
manage_settings
View and manage Gmail settings including vacation responder (auto-reply), mail filters, forwarding addresses, and send-as aliases with signatures.
manage_draft
Create, update, send, list, get, or delete email drafts. Drafts can be composed with recipients, subject, body, and then sent when ready.
manage_labels
List, create, update, get, or delete Gmail labels. Labels organize messages and threads (e.g., INBOX, SENT, STARRED, or custom labels).
manage_thread
Get, list, modify labels, trash, or restore email conversation threads. Retrieve full thread conversations with all messages.
search_messages
Search and list email messages using Gmail query syntax. Returns parsed messages with headers, body, and attachment metadata. Use the same search operators available in the Gmail search bar: `from:`, `to:`, `subject:`, `has:attachment`, `after:`, `before:`, `is:unread`, `label:`, etc.
get_message
Retrieve a single email message by its ID. Returns the full message including parsed headers, body (text and HTML), and attachment metadata.
send_email
Send an email message to one or more recipients. Supports plain text and HTML bodies, CC/BCC recipients, file attachments (base64-encoded), and replying within existing threads.
get_attachment
Download an email attachment by its ID. Returns the attachment as a file attachment plus its size. Use the attachment IDs from the message's attachments list.
search_google_contacts
Searches the authenticated user's Google Contacts from the People API by name, email address, phone number, or other fields.
list_google_contacts
Lists the authenticated user's Google Contacts from the People API with pagination support. Use the `pageToken` from a previous response to fetch the next page.
get_google_contact
Retrieves detailed Google Contacts information for a People API resource name. Use `people/me` to get the authenticated user profile.
delete_messages_permanently
Immediately and permanently delete one or more Gmail messages. This bypasses Trash and cannot be undone.
delete_thread_permanently
Immediately and permanently delete a Gmail thread and all messages in it. This bypasses Trash and cannot be undone.
Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Configure mail settings including forwarding rules, filters, vacation responders, signatures, aliases, and delegates. Import and insert messages for migration. Sync mailbox changes incrementally via history API. Subscribe to mailbox change notifications via push notifications.
Common questions about connecting Gmail to AI agents with Metorial.