Hub

Delete a task outright. Unlike mail and Drive, Google Tasks has no trash — this is permanent.

Download a file as base64 — PDFs, images, archives, anything not text. 2 MB limit. For a Google Doc, Sheet or Slides, `export_as` converts it on the way out: pdf, docx, xlsx, pptx, csv, html, md and more. That is how you turn a Doc into a PDF or a Sheet into a spreadsheet file.

Forward a message to new recipients, carrying its attachments along (10 MB total cap; larger ones are named as skipped).

Read one attachment. PDFs, Word, Excel, PowerPoint, OpenDocument and text-like files come back as TEXT, so an emailed contract or invoice can be read directly; anything else comes back base64-encoded (2 MB limit). Get attachment ids from get_message or get_thread.

Fetch one draft in full, including its body.

One event in full: attendees with their RSVPs, conference link, description, and this account's own response.

Everything about one file except its contents: type, size, owners, timestamps, sharing state, link.

Who can see a file and at what level — the check to run before sharing anything further.

Fetch one message in full: body text plus attachment metadata (use get_attachment for the file itself).

Fetch an entire conversation thread with every message body and attachment metadata.

List every account linked to this server — Google accounts and AOL mailboxes — with link status and what each can reach.

List the calendars on one account, or on every linked account when `account` is omitted — primary, shared, and subscribed, with the access level held on each.

Recently updated contacts. Omit `account` to merge every linked address book.

List drafts in a mailbox.

Events in a time window, sorted by start. Omit `account` to merge EVERY linked calendar into one timeline — the cross-account view of a day or week that a single-account connector cannot produce. Defaults to the next 7 days. Recurring series are expanded into their actual occurrences.

List label ids and names for a mailbox.

Most recently modified files, newest first, across My Drive and every shared drive. Omit `account` to merge every linked Drive.

Shared drives (Team Drives) this account belongs to — the drives owned by an organisation rather than by a person. Omit `account` to list them across every linked account. Use an id here as `drive_id` to confine a search to one drive.

The task lists on one account, or on every linked account when `account` is omitted.

Open tasks, soonest due first. Omit `account` to merge every linked account's list into one to-do list. Completed tasks are hidden unless show_completed is true.

Mark a message (message_id) or thread (thread_id) as spam — or undo it with unmark: true, which restores it to the inbox.

Add or remove labels on a message (message_id) or a whole thread (thread_id). Use label ids from list_labels, or built-ins like UNREAD, STARRED, IMPORTANT, INBOX. Removing INBOX archives. On AOL, labels are folders: a message is in one at a time, so adding a folder label moves it there (and gives it a new id, returned as new_message_id); IMPORTANT and categories do not exist.

Read a file as text. Handles Google Docs, Sheets and Slides (exported, Sheets as CSV), PDFs, Word, Excel, PowerPoint and OpenDocument files, and plain text, Markdown, JSON, CSV and code. Capped at 60 KB with the cut flagged. If a PDF turns out to be a scan, or an image needs reading, retry with ocr: true — that routes it through Google's own conversion.

Reply in-thread immediately, preserving subject and threading headers. To let the user review first, use create_draft with reply_to_message_id.

RSVP to an invitation as the account that received it: accepted, declined or tentative. The organiser is notified by default, since an RSVP nobody sees is not an RSVP.

Find someone by name, email or company across saved contacts AND people the account has corresponded with. Omit `account` to search every linked account. Use this to resolve "email Ann" into an address rather than guessing one.

Find events by free text — title, description, location or attendee. Omit `account` to search every linked calendar at once. Searches the next year by default; pass time_min/time_max to look further back.

Search Drive by text across file names and contents. Omit `account` to search EVERY linked Drive at once. Covers My Drive AND every shared drive the account belongs to; `drive_id` narrows to one shared drive. Add `filter` for Drive query syntax (mimeType, modifiedTime, starred, "'me' in owners"). Trashed files are excluded unless your filter says otherwise.

Search mail using Gmail query syntax (from:, subject:, is:unread, newer_than:7d, has:attachment). Omit `account` to search EVERY linked mailbox at once — Gmail and AOL — and get merged, date-sorted results. AOL mailboxes understand from: to: cc: bcc: subject: is:unread/read/starred has:attachment newer_than: older_than: after: before: in: label: larger: smaller:, quoted phrases, OR, - and parentheses; other operators are refused for them by name rather than ignored. For more results from one mailbox, pass its next_page_token back as page_token with that account.

Search whole conversations instead of individual messages, using the same Gmail query syntax. A thread matches when any message in it does, and comes back as one row: subject, every participant, message count, unread count and when it last moved — the shape to use for "where does my thread with X stand". Omit `account` to search EVERY linked mailbox at once, merged and sorted by latest activity. Follow up with get_thread for the message bodies.

Send an existing draft as-is.

Send a new email immediately from a specific linked mailbox. To let the user review first, use create_draft instead.

Description is built at runtime.

Find open slots of a given length. Omit `account` to require the slot be free on EVERY linked calendar at once — the cross-account availability question, answered in one call. Returns the free gaps themselves, so a 3-hour gap comes back once rather than as six half-hour slots.

Move a file to the Drive trash, where it is recoverable for 30 days. Nothing here deletes permanently. On a file you do not own this returns a draft and removes nothing until confirm_edit is passed.

Move a message (message_id) or whole thread (thread_id) to Trash. Recoverable with untrash_message until the mailbox empties its Trash (30 days on Gmail) — this server never deletes mail permanently.

Withdraw access previously granted: from one person by email, from a domain, or by removing the public link entirely (public: true). Name the holder or pass a permission_id from get_file_permissions. This is the undo for share_file — reach for it whenever a file turned out to be shared more widely than intended.

Restore a file from the Drive trash. The undo for trash_file, within the 30-day window.

Restore a message (message_id) or whole thread (thread_id) from Trash.

Replace a draft's content entirely. Provide the complete new to/subject/body — this overwrites, not merges. On AOL the draft is saved anew, so use the draft_id in the result from then on.

Change an existing event. Only the fields you pass are touched — everything else keeps its value. Passing `attendees` REPLACES the guest list rather than adding to it. On a repeating event, `scope` chooses between the one occurrence and the whole series; the result says which it changed.

Rename a file, change its description, or move it between folders. Replacing the contents is possible but deliberately awkward: it needs BOTH `content` and replace_content: true, so a rename can never overwrite a document by accident. ON A FILE YOU DO NOT OWN this edits a private copy instead and tells you so; to change the original, pass edit_original: true to get a draft, show it to the user, and only then confirm_edit.

Rename a user label.

Change a task, or tick it off with completed: true (completed: false reopens it). Only the fields you pass are touched.