Send a new email.

to/cc/bcc: recipient address lists. attachments: file paths on the server host. sender: optional explicit From (defaults to the account's primary send-as address). Provide body_text and/or body_html. password: the account's password — required when password protection is enabled.

Reply to a message, keeping it in the same thread.

reply_all=True also copies the original To/Cc recipients (minus yourself).

Forward a message to new recipients, optionally re-attaching its attachments.

body_text is prepended before the quoted original. Starts a new thread.

Create a draft. thread_id attaches it to an existing thread (e.g. a reply draft).

List drafts with subject/recipient summaries and next_page_token.

Send an existing draft.

Replace a draft's contents (Gmail replaces the whole message — pass all fields you want).

Permanently delete a draft (the draft only — not a sent message).

Get the Gmail profile (email address, message/thread totals, historyId).

account: which configured account to use (alias or email). Optional when only one account is configured. password: the account's password — required when password protection is enabled.

Get a single message fully decoded: headers, snippet, text/HTML body, attachment list.

Search messages using Gmail query syntax (e.g. 'is:unread from:alice newer_than:7d').

Returns message summaries plus next_page_token for pagination.

Search threads using Gmail query syntax. Returns thread stubs + next_page_token.

Get a full thread with every message decoded.

List a message's attachments (filename, mimeType, size, attachmentId).

Download an attachment to save_path on the server host.

Get attachment_id from get_message_attachments or get_message.

Move a message to Trash (recoverable; not a permanent delete).

Restore a message from Trash.

Move an entire thread to Trash.

Restore an entire thread from Trash.

List all labels (system and user) with their ids.

Create a label. Use '/' in name for nesting (e.g. 'Clients/Acme').

Rename or change visibility of a label (identified by name or id).

Delete a label (identified by name or id).

Add one or more labels to a message.

Remove one or more labels from a message.

Add one or more labels to every message in a thread.

Remove one or more labels from every message in a thread.

List all filters with their ids, criteria, and actions.

Create a filter.

Criteria: from_address, to_address, subject, query (Gmail search syntax), negated_query, has_attachment, exclude_chats, size + size_comparison ('larger'/'smaller'). Actions: add_labels/remove_labels (names or ids), forward_to, and the booleans mark_read, archive (skip Inbox), star, mark_important, never_mark_important, never_spam, trash.

Delete a filter by id (get ids from list_filters).

Get the HTML signature for a send-as address (defaults to the primary address).

Set the HTML signature for a send-as address (defaults to the primary address).

Get the vacation responder (auto-reply) settings.

Enable or disable the vacation responder.

start_time/end_time are epoch-milliseconds strings (omit for no bound). restrict_to_contacts/restrict_to_domain limit who receives the auto-reply.

Mark a message as read (removes the UNREAD label).

Mark a message as unread (adds the UNREAD label).

Star a message.

Remove the star from a message.

Archive a message (removes it from the Inbox).

Move a message back to the Inbox.

Mark a message as important.

Mark a message as not important.

Add and/or remove labels across many messages in one call.

add_labels/remove_labels accept label names or ids.

Move many messages to Trash in one call.

Restore many messages from Trash in one call.

List/search events on a calendar.

time_min/time_max are RFC3339 (e.g. '2026-06-15T00:00:00Z'). query is free-text search. single_events=True expands recurring events into instances (required for order_by='startTime'). Returns rendered events + next_page_token.

Get a single event.

Create an event.

Time: pass start/end as RFC3339 dateTimes with time_zone (IANA), or all_day=true with 'YYYY-MM-DD'. recurrence is a list of RRULE strings. attendees/optional_attendees are email lists. add_meet=true attaches a Google Meet link. reminders is a list of {method:'popup'|'email', minutes:int}. send_updates ∈ all/externalOnly/none. extra_fields merges any other Calendar event fields.

Update an event (patch — only the fields you pass are changed).

Delete an event. send_updates ∈ all/externalOnly/none notifies attendees.

Create an event from natural language (e.g. 'Lunch with Sam tomorrow 1pm').

Move an event from one calendar to another.

List the individual instances of a recurring event.

RSVP to an event you're invited to. response ∈ accepted/declined/tentative.

Import an event (adds a copy carrying an existing iCalUID, e.g. from an .ics).

List the calendars in this account (with access role, color, primary/selected flags).

min_access_role ∈ freeBusyReader/reader/writer/owner filters the list.

Get a calendar's metadata (summary, description, timeZone, location).

Create a new secondary calendar.

Update a calendar's metadata (patch).

Delete a secondary calendar (cannot delete the primary calendar).

Delete ALL events from a primary calendar (only works on a primary calendar).

Add an existing calendar (by id) to this account's calendar list.

Remove a calendar from this account's calendar list (does not delete the calendar).

Change how a calendar appears in your list: color, selected, hidden, name override, reminders.

List the access-control rules (who the calendar is shared with) and their ruleIds.

Share a calendar.

role ∈ reader/writer/owner/freeBusyReader. scope_type ∈ user/group/domain/default; scope_value is the email/domain (omit for 'default' = public).

Change the role of an existing share (get ruleId from list_acl).

Remove a share / access rule (get ruleId from list_acl).

Query busy time ranges across one or more calendars between time_min and time_max (RFC3339).

calendar_ids defaults to ['primary']. Returns busy slots per calendar.

List all user calendar settings (timezone, week start, default reminders, etc.).

Get a single user calendar setting by id (e.g. 'timezone', 'weekStart').

Get the calendar and event color palettes (colorId -> hex values).