Gmail

See the apps the current caller can act on and whether they are connected. Returns each app's id, name, connected state, and (when connected) the account it is connected as. Call this to answer "what apps do I have?" or when the caller's connection state may have changed since the session started.

Add or remove one user-created label on at most 50 messages per call. A message already in the requested state is a noop, but the tool is not idempotent in query mode: repeated calls with the same query advance to the next chunk, so a blind retry can label further messages. This lane does not accept Gmail system labels or triage state changes. Selector and label validation finish before mutation. Query selectors may match more than 50 messages; each call processes up to 50 remaining actionable m

Add and remove labels on every message in a thread using the Gmail API. Use this to change a whole conversation at once (for example, marking a thread read by removing "UNREAD") instead of modifying each message. Label names match case-insensitively when there is no exact match. The confirmation reflects the labels actually present across the thread after the change, not the requested input.

Create a new label in the user's mailbox. Gmail treats label names as case-insensitive-unique; creating a name that already exists reports a conflict rather than a duplicate. Documented Gmail reserved SYSTEM label names (INBOX, SPAM, TRASH, …) are rejected before calling Gmail. Google's published list is non-exhaustive; upstream create errors remain the backstop for any other reserved name.

Delete a user-created label, resolving it by the name the user says. A misspelled name gets a close-match suggestion; a system label is rejected. Deleting a label removes it from the mailbox and from every message it was applied to.

Send a copy of one message to new recipients as a new conversation. The forward quotes the original body, prefixes the subject with ``Fwd:``, carries filename-bearing attachments, and prepends the optional note. It does not reply to or change the original conversation.

Read one message by ID without loading the rest of its thread. Returns parsed sender and recipient headers, the subject, text and HTML bodies, labels, dates, and attachment metadata. Attachment file bytes are not returned.

List metadata for a message's real attachments without loading their contents. Only genuine attachments are reported; unnamed body parts and body-embedded inline images are excluded. Each row includes its filename, MIME type, size, and Gmail attachment id when Gmail provides one.

Read emails from a Gmail account. By default returns metadata-only rows (no body/html_body) so high-volume triage stays within the context budget. Pass include_body=True when full message text is needed. Metadata rows still include routing headers (to/cc/bcc/from/reply_to) and email_addresses. Obvious automated emails are excluded from results using no-reply sender patterns and Gmail's non-primary category filters (promotions, social, updates, forums). Set exclude_automated=False to include all

Search for emails by header using the Gmail API. By default returns metadata-only rows (no body/html_body). Pass include_body=True when full message text is needed. Metadata rows still include routing headers (to/cc/bcc/from/reply_to) and email_addresses.

List threads in the user's mailbox. By default, obvious automated threads are excluded from results using no-reply sender patterns and Gmail's non-primary category filters (promotions, social, updates, forums). Set exclude_automated=False to include all threads regardless of source.

Send a reply to an email message, optionally with one or more file attachments. To attach files, pass ``attachments`` and give each file's local path as a ``file://`` URI in ``source`` (formatted ``file:///absolute/path/to/file``). The file's bytes are read and substituted on the client before the request is sent, so the contents never pass through this conversation. Do not read, encode, or inline the bytes yourself.

Search Gmail with a raw query and return one page in the requested detail mode. Results follow Gmail's default newest-first order. The default ``lightweight`` mode is metadata-only (routing/threading headers, no bodies). Count-only returns unhydrated identifier stubs plus Gmail's approximate match total — useful to estimate how many emails a query would affect before applying a bulk change. Full results add parsed plain and HTML bodies. ``pagination.total_estimate`` is always approximate.

Send an email using the Gmail API, optionally with one or more file attachments. To attach files, pass ``attachments`` and give each file's local path as a ``file://`` URI in ``source`` (formatted ``file:///absolute/path/to/file``). The file's bytes are read and substituted on the client before the request is sent, so the contents never pass through this conversation. Do not read, encode, or inline the bytes yourself.

Set whether an entire conversation is in Trash, affecting every message at once. Setting the current status again succeeds without changing the conversation.

Apply one triage transition to at most 50 selected messages per call. Per-message transitions converge — a message already in the requested state is a noop — but the tool is not idempotent in query mode: repeated calls with the same query advance to the next chunk, so a blind retry can mutate further messages. This lane owns read/unread, star/unstar, unarchive, untrash, importance, and not-spam. Archive, trash, and report_spam are not available on this tool. ``untrash`` uses per-message restore;

Request removal from authenticated marketing mail and optionally trash it. Success means the unsubscribe *request* was accepted or sent — not that the sender has finished removing the subscription. When trash is requested, ``trash_completed`` is true only after a verified expected-id + TRASH-label response; unverified or cancelled trash cleanup returns non-retryable ``partial`` uncertainty (do not retry / resend). Plain HTTPS ``manual_url`` values are signed/syntax-selected untrusted opaque navi

Update an existing email draft using the Gmail API. Single-part ``text/plain`` and single-part ``text/html`` drafts both support full body replacement; the rebuild follows the existing draft's content type, so a plain draft stays plain and an HTML draft stays HTML. Plain-text input supplied against an HTML draft is auto-converted to HTML, and HTML input supplied against a plain draft is stored verbatim as ``text/plain``. Reply drafts preserve their reply-quote tail (``> `` lines for plain, ``<bl

Rename a user-created label, resolving it by the name the user says. The label's color and visibility settings are preserved. A misspelled name gets a close-match suggestion; a system label is rejected; renaming to a name that already exists reports a conflict. Documented reserved SYSTEM label names are rejected as the new name before calling Gmail (Google's list is non-exhaustive; upstream errors remain the backstop).

Get comprehensive user profile and Gmail account information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Gmail account statistics, and other important profile details from Google services.

Compose a new email draft using the Gmail API, optionally with file attachments. To attach files, pass ``attachments`` and give each file's local path as a ``file://`` URI in ``source`` (formatted ``file:///absolute/path/to/file``). The file's bytes are read and substituted on the client before the request is sent, so the contents never pass through this conversation. Do not read, encode, or inline the bytes yourself.

Compose a draft reply to an email message, optionally with one or more file attachments. To attach files, pass ``attachments`` and give each file's local path as a ``file://`` URI in ``source`` (formatted ``file:///absolute/path/to/file``). The file's bytes are read and substituted on the client before the request is sent, so the contents never pass through this conversation. Do not read, encode, or inline the bytes yourself.