Welcome to the Gmail integration docs. Once you connect your Gmail account to Reasoning Stack, your AI agents and workflows can use the following tools to manage emails, contacts, threads, and labels efficiently.
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.
Deleting an email or draft is irreversible. Use GMAIL_DELETE_MESSAGE and GMAIL_DELETE_DRAFT with caution.

​
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.
For automation, combine fetching, label management, and sending tools to build advanced workflows.