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.
Inbox & Threads
Section titled “Inbox & Threads”Browse your inbox structure and read threads.
| Tool | Description | Parameters |
|---|---|---|
list-inbox-splits | List all inbox splits in display order — Primary, system splits (Needs Reply, Follow Ups), custom splits, and categories | — |
get-inbox-split-threads | List threads in a specific split, category, or system split. Provide exactly one filter. | splitId, category, systemSplit, 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 |
get-thread-summary | AI-generated thread summary — much more token-efficient than reading the full thread | threadId |
Compose & Reply
Section titled “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
Section titled “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 Views
Section titled “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
Section titled “Labels”Organize threads with labels.
| Tool | Description | Parameters |
|---|---|---|
list-labels | List all labels with IDs, names, and colors | — |
create-label | Create a new label | name, 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
Section titled “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
Section titled “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 Splits
Section titled “Inbox Splits”Create and manage custom inbox views.
| Tool | Description | Parameters |
|---|---|---|
create-inbox-split | Create a custom inbox split that filters threads by query | name, query, showInCategorySplit |
update-inbox-split | Update a split’s name, query, or visibility | splitId, name, query, showInCategorySplit |
delete-inbox-split | Permanently delete a custom split | splitId |
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
Section titled “Account & Settings”User profile, contacts, organization, and preferences.
| Tool | Description | Parameters |
|---|---|---|
get-self | Your profile, account status, settings, org memberships, and unread counts | — |
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
Section titled “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).