Tools

Your AI assistant picks the right tool automatically based on what you ask. This page is a reference for all available tools, grouped by category.

Tip

You don’t need to memorize tool names. Just ask your AI assistant what you want in natural language, and it will choose the appropriate tools.

Inbox & Threads

Browse your inbox structure and read threads.

Tool	Description	Parameters
list-inbox-tabs	List all inbox tabs in display order – Primary, system tabs (Needs Reply, Follow Ups, Noise), custom tabs, and category tabs. Unread counts are included only when requested.	includeUnreadCounts
get-inbox-unread-count	Unread thread count for one custom tab, category tab, or system tab. Provide at most one filter; none returns the whole-inbox total.	tabId, category, systemTab
get-inbox-tab-threads	List threads in a specific custom tab, category tab, or system tab. Provide exactly one filter.	tabId, category, systemTab, limit, pageToken
search-inbox	Full-text search across all threads by keyword or phrase	query, limit, pageToken
read-thread	Read a thread with its messages. Use "concise" for snippets, "detailed" for full bodies.	threadId, response_format

Compose & Reply

Send new emails and reply to existing threads.

Tool	Description	Parameters
compose-thread	Create and send a new email thread	to, body, subject, cc, bcc, channelIds
reply-to-thread	Send a reply in an existing thread	threadId, to, body, cc, bcc
generate-draft	Generate an AI-powered draft reply tuned to your writing style	threadId, customInstructions, currentDraftBody

Thread Actions

Triage and organize individual threads.

Tool	Description	Parameters
done-thread	Archive / mark a thread as done, removing it from the inbox	inboxItemIds
snooze-thread	Snooze a thread until a specific date/time so it reappears later	threadId, snoozeUntil (ISO 8601)
star-threads	Star or unstar one or more threads	threadIds, starred
mark-read	Mark all messages in a thread as read	threadId
trash-threads	Move threads to trash or restore them	threadIds, trashed
mark-spam	Mark or unmark a thread as spam	threadId, spam
move-to-category	Move threads between inbox categories (Primary, Promotions, etc.)	threadIds, fromCategory, toCategory

Thread Jobs

Run larger background operations over thread sources. Use normal thread tools for one thread, and immediate bulk tools for small explicit lists. For larger sets, roughly more than 20 threads, or when the source is an inbox tab, label, channel, folder, or search query, create a thread job and monitor it.

Tool	Description	Parameters
create-thread-job	Create a background job over a thread source with an action	source, action
get-thread-job	Get one thread job’s state and progress. Minimal by default; use response: "full" for source/action/timestamps.	threadJobId, response
list-thread-jobs	List recent non-dismissed thread jobs in compact form for discovery/debug	limit
dismiss-thread-job	Dismiss a terminal thread job so it no longer appears in job lists	threadJobId

Thread Views

Browse threads by folder.

Tool	Description	Parameters
list-sent-threads	List threads from the Sent folder	limit, pageToken
list-starred-threads	List starred/flagged threads	limit, pageToken
list-snoozed-threads	List snoozed threads that will reappear later	limit, pageToken
list-scheduled-threads	List threads with messages scheduled for future delivery	limit, pageToken
list-trashed-threads	List threads in the Trash	limit, pageToken
list-spam-threads	List threads marked as spam	limit, pageToken

Labels

Organize threads with labels.

Tool	Description	Parameters
list-labels	List all labels with IDs, names, and colors	–
create-label	Propose creating one or more new labels in a single confirmation card	labels (each name, optional color)
get-label-threads	List threads with a specific label	labelId, limit, pageToken
manage-thread-labels	Add or remove labels on one or more threads	threadIds, labelIds, action

Channels

Team shared spaces for organizing threads.

Tool	Description	Parameters
list-channels	List all channels you belong to	–
create-channel	Create a new team channel	name, organizationId, isPublic, color
get-channel-threads	List threads in a channel	channelId, limit, pageToken
manage-thread-channels	Add or remove threads from channels	threadIds, channelIds, action
manage-channel-participants	Add or remove members from a channel	channelId, participantIds, action

Comments & Followers

Internal team collaboration on threads.

Tool	Description	Parameters
read-thread-comments	Read internal team comments on a thread (not visible to external recipients)	threadId, organizationId, response_format
post-thread-comment	Post an internal comment visible only to organization members	threadId, organizationId, body
manage-thread-followers	Add or remove followers who get notifications about thread activity	threadId, userIds, action

Inbox Tabs

Create and manage custom inbox views.

Tool	Description	Parameters
create-inbox-tab	Create a custom inbox tab that filters threads by query	name, query, alsoShowInPrimary
update-inbox-tab	Update a tab’s name, query, or visibility	tabId, name, query, alsoShowInPrimary
delete-inbox-tab	Permanently delete a custom tab	tabId

Rules

Automate inbox organization with rules that match incoming emails.

Tool	Description	Parameters
list-rules	List all automation rules with their queries, actions, and status	–
create-rule	Create a rule that auto-applies actions to matching emails. Actions: ADD_TO_CHANNEL, ADD_LABEL, STAR, MARK_AS_SPAM.	query, actions, applyToIncoming, bulkApplication
update-rule	Update an existing rule’s query or actions	ruleId, query, actions
delete-rule	Permanently delete a rule	ruleId

Account & Settings

User profile, contacts, organization, and preferences.

Tool	Description	Parameters
get-self	Your profile, email sync status, and org memberships. Use "detailed" for full settings and unread counts.	response_format
list-org-members	List all members of an organization	organizationId
list-contacts	List all contacts you’ve interacted with	–
update-settings	Update settings: AI auto-drafts, auto-advance, branding signature	autoDraftEnabled, autoAdvanceEnabled, brandingSignatureEnabled

Pagination

Many tools return paginated results. When a response includes a pageToken, pass it back to the same tool to fetch the next page. The limit parameter controls page size (typically 1–50, defaulting to 20).