Tools

Reference

Tool	What it does
search_email	Searches the connected inbox and returns matching messages.
read_email	Reads the full content of a specific email by message ID.
read_email_thread	Reads every message in an email conversation thread.
list_email_labels	Lists every label in the connected account.
list_emails_by_label	Lists recent emails carrying a specific label.
create_draft	Creates a new email draft. Only ever saves it, never sends it.
create_draft_reply	Creates a draft that replies within an existing thread, properly threaded.
create_draft_with_attachment	Creates a draft with a file attached from the sandbox workspace.
list_drafts	Lists saved drafts.
read_draft	Reads the full content of a specific saved draft.
update_draft	Replaces the recipient, subject, and body of an existing draft.
delete_draft	Permanently deletes a saved draft.

Finding messages

search_email, read_email, read_email_thread, list_email_labels, and list_emails_by_label cover locating and reading messages, individually or as a whole conversation.

Drafts

create_draft, create_draft_reply, create_draft_with_attachment, list_drafts, read_draft, update_draft, and delete_draft cover the full lifecycle of a draft. None of them can send a message.

Ambiguous requests

If a request is ambiguous, for example when more than one email plausibly matches a description like the invoice from last week, tAI shows you the candidates it found instead of guessing which one you meant, so you can point it at the right one.