taylorwilsdon/google_workspace_mcp

The user's Google email address. Required.

The ID of the spreadsheet. Required.

The ID of the table to append to (get from list_sheet_tables). Required.

2D array of values to append. Each inner list is one row. Can be a JSON string or Python list. Required.

The user's Google email address. Required.

A list of message IDs to modify.

List of label IDs to add to the messages.

List of label IDs to remove from the messages.

User's Google email address

ID of the document to update

List of operation dicts. Each operation MUST have a 'type' field. All operations accept an optional 'tab_id' to target a specific tab.

The user's Google email address. Required.

The ID of the form to update.

List of update requests to apply. Supported request types: - createItem: Add a new question or content item - updateItem: Modify an existing item - deleteItem: Remove an item - moveItem: Reorder an item - updateFormInfo: Update form title/description - updateSettings: Modify form settings (e.g., quiz mode)

The user's Google email address. Required.

The ID of the presentation to update.

List of update requests to apply.

The user's Google email address. Required.

The name of the file to check.

ID of the shared drive to scope the search to. When set, the underlying files.list call uses corpora='drive' and the given driveId, which is required to reliably find files that live only in that shared drive. When None, behaviour is unchanged (default API corpora applies).

The user's Google email address. Required.

The ID of the file to copy. Required.

New name for the copied file. If not provided, uses "Copy of [original name]".

The ID of the folder where the copy should be created. Defaults to 'root' (My Drive).

The user's Google email address. Required.

The title/name of the new calendar.

An optional description for the calendar.

IANA timezone for the calendar (e.g. 'America/New_York').

User's Google email address

Title of the new document

Optional initial plain text content to insert

The user's Google email address. Required.

The name for the new file.

If provided, the content to write to the file.

The ID of the parent folder. Defaults to 'root'. For shared drives, this must be a folder ID within the shared drive.

The MIME type of the file. Defaults to 'text/plain'.

If provided, fetches the file content from this URL. Supports file://, http://, and https:// protocols.

Standard base64-encoded file bytes.

MIME type for base64_content uploads.

The user's Google email address. Required.

The name for the new folder.

The ID of the parent folder. Defaults to 'root'. For shared drives, use a folder ID within that shared drive.

The user's Google email address. Required.

The title of the form.

The description of the form.

The document title (shown in browser tab).

The user's Google email address. Required.

The title for the new presentation. Defaults to "Untitled Presentation".

The message resource name (e.g. spaces/X/messages/Y).

The emoji character to react with (e.g. 👍).

User's email address

Project title

Optional Drive folder ID or bound container ID

The user's Google email address. Required.

The title of the new spreadsheet. Required.

List of sheet names to create. If not provided, creates one sheet with default name.

User's Google email address

ID of the document to update

2D list of strings - EXACT format: [["col1", "col2"], ["row1col1", "row1col2"]]

Document position (MANDATORY: get from inspect_doc_structure 'total_length')

Whether to make first row bold (default: true)

Optional tab ID to create the table in a specific tab

User's email address

The script project ID

Optional description for this version

User's Google email address

ID of the document to inspect

Which table to debug (0 = first table, 1 = second table, etc.)

User's email address

The script project ID to delete

The message resource name (e.g. spaces/X/messages/Y).

Zero-based index of the attachment to download (default 0).

The user's Google email address. Required for authentication.

Email subject.

Email body (plain text).

Email body format. Use 'plain' for plaintext or 'html' for HTML content.

Optional recipient email address.

Optional CC email address.

Optional BCC email address.

Optional sender display name (e.g., 'Peter Hartree'). If provided, the From header will be formatted as 'Name <email>'.

Optional 'Send As' alias email address. Must be configured in Gmail settings (Settings > Accounts > Send mail as). If not provided, uses the authenticated user's email.

Optional Gmail thread ID to reply within.

Optional RFC Message-ID of the message being replied to (e.g., '<message123@gmail.com>').

Optional chain of Message-IDs for proper threading.

Optional list of attachments. Each can have: 'url' (fetch from URL — works with MCP attachment URLs from get_drive_file_download_url / get_gmail_attachment_content), OR 'path' (file path, auto-encodes), OR 'content' (standard base64, not urlsafe) + 'filename'. Optional 'mime_type'. Optional 'content_id' (string) makes the attachment inline-rendered: it lands in a multipart/related part with `Content-ID: <content_id>` and `Content-Disposition: inline`, and the HTML body can reference it via `<img src="cid:<content_id>">` (RFC 2392). Without `content_id` the attachment is a regular multipart/mixed attachment.

Whether to append the Gmail signature from Settings > Signature when available. Defaults to true.

Whether to include the original message as a quoted reply. Requires thread_id. Defaults to false.

User's Google email address

ID of the Google Doc to export

Name for the PDF file (optional - if not provided, uses original name + "_PDF")

Drive folder ID to save PDF in (optional - if not provided, saves in root)

User's Google email address

ID of the document to update

Text to search for

Text to replace with

Whether to match case exactly

Optional ID of the tab to target

The user's Google email address. Required.

The ID of the spreadsheet. Required.

A1-style range (optionally with sheet name). Required.

Hex background color (e.g., "#FFEECC").

Hex text color (e.g., "#000000").

Sheets number format type (e.g., "DATE").

Custom pattern for the number format.

Text wrap strategy - WRAP (wrap text within cell), CLIP (clip text at cell boundary), or OVERFLOW_CELL (allow text to overflow into adjacent empty cells).

Horizontal text alignment - LEFT, CENTER, or RIGHT.

Vertical text alignment - TOP, MIDDLE, or BOTTOM.

Whether to apply bold formatting.

Whether to apply italic formatting.

Font size in points.

Type of trigger. One of: - "time_minutes" (run every N minutes: 1, 5, 10, 15, 30) - "time_hours" (run every N hours: 1, 2, 4, 6, 8, 12) - "time_daily" (run daily at a specific hour: 0-23) - "time_weekly" (run weekly on a specific day) - "on_open" (simple trigger - runs when document opens) - "on_edit" (simple trigger - runs when user edits) - "on_form_submit" (runs when form is submitted) - "on_change" (runs when content changes)

The function to run when trigger fires (e.g., "sendDailyReport")

Schedule details (depends on trigger_type): - For time_minutes: "1", "5", "10", "15", or "30" - For time_hours: "1", "2", "4", "6", "8", or "12" - For time_daily: hour as "0"-"23" (e.g., "9" for 9am) - For time_weekly: "MONDAY", "TUESDAY", etc. - For simple triggers (on_open, on_edit): not needed

The user's Google email address. Required.

The contact ID (e.g., "c1234567890" or full resource name "people/c1234567890").

The user's Google email address. Required.

The contact group ID.

Maximum number of members to return (default: 100, max: 1000).

User's Google email address

ID of the Google Doc (or full URL)

Whether to include comments (default: True)

How to display comments: - "inline": Footnote-style references placed at the anchor text location (default) - "appendix": All comments grouped at the bottom with blockquoted anchor text - "none": No comments included

Whether to include resolved comments (default: False)

How to render suggestions in the returned content: - "DEFAULT_FOR_CURRENT_ACCESS": Default based on user's access level - "SUGGESTIONS_INLINE": Suggested changes appear inline in the document - "PREVIEW_SUGGESTIONS_ACCEPTED": Preview as if all suggestions were accepted - "PREVIEW_WITHOUT_SUGGESTIONS": Preview as if all suggestions were rejected

User's Google email address

ID of the Google Doc (or full URL)

How to render suggestions in the returned content: - "DEFAULT_FOR_CURRENT_ACCESS": Default based on user's access level - "SUGGESTIONS_INLINE": Suggested changes appear inline in the document - "PREVIEW_SUGGESTIONS_ACCEPTED": Preview as if all suggestions were accepted - "PREVIEW_WITHOUT_SUGGESTIONS": Preview as if all suggestions were rejected

The user’s Google email address.

Drive file ID.

The user's Google email address. Required.

The Google Drive file ID to download.

Optional export format for Google native files. Options: 'pdf', 'docx', 'xlsx', 'csv', 'pptx'. If not specified, uses sensible defaults (PDF for Docs/Slides, XLSX for Sheets). For Sheets: supports 'csv', 'pdf', or 'xlsx' (default).

The user's Google email address. Required.

The ID of the file to check permissions for.

The user's Google email address. Required.

The ID of the file or folder to get the shareable link for. Required.

The user's Google email address. Required.

The ID of the calendar to query. Use 'primary' for the user's primary calendar. Defaults to 'primary'. Calendar IDs can be obtained using `list_calendars`.

The ID of a specific event to retrieve. If provided, retrieves only this event and ignores time filtering parameters.

The start of the time range (inclusive) in RFC3339 format (e.g., '2024-05-12T10:00:00Z' or '2024-05-12'). If omitted, defaults to the current time. Ignored if event_id is provided.

The end of the time range (exclusive) in RFC3339 format. If omitted, events starting from `time_min` onwards are considered (up to `max_results`). Ignored if event_id is provided.

The maximum number of events to return. Defaults to 25. Ignored if event_id is provided.

A keyword to search for within event fields (summary, description, location). Ignored if event_id is provided.

Whether to return detailed event information including description, location, attendees, and attendee details (response status, organizer, optional flags). Defaults to False.

Whether to include attachment information in detailed event output. When True, shows attachment details (fileId, fileUrl, mimeType, title) for events that have attachments. Only applies when detailed=True. Set this to True when you need to view or access files that have been attached to calendar events, such as meeting documents, presentations, or other shared files. Defaults to False.

The user's Google email address. Required.

The ID of the form to retrieve.

The user's Google email address. Required.

The ID of the form.

The ID of the response to retrieve.

The ID of the Gmail message containing the attachment.

The ID of the attachment to download.

The user's Google email address. Required.

When True, includes the full attachment as a standard base64 string in the response (in addition to any file path or download URL). Useful for sandboxed clients that cannot reach localhost download URLs or the MCP server's local file paths (e.g. containerized agents with network allowlists). The returned base64 uses the standard alphabet, so it can be passed directly to tools like ``draft_gmail_message`` that expect standard (not URL-safe) base64. Default False preserves the existing behavior and response size.

The unique ID of the Gmail message to retrieve.

The user's Google email address. Required.

Body output format. 'text' (default) returns plaintext (HTML converted to text as fallback). 'html' returns the raw HTML body as-is without conversion. 'raw' fetches the full raw MIME message and returns the base64url-decoded content.

List of Gmail message IDs to retrieve (max 25 per batch).

The user's Google email address. Required.

Message format. "full" includes body, "metadata" only headers.

Body output format (only applies when format='full'). 'text' (default) returns plaintext (HTML converted to text as fallback). 'html' returns the raw HTML body as-is without conversion. 'raw' fetches the full raw MIME message and returns the base64url-decoded content.

The unique ID of the Gmail thread to retrieve.

The user's Google email address. Required.

Body output format. 'text' (default) returns plaintext (HTML converted to text as fallback). 'html' returns the raw HTML body as-is without conversion. 'raw' fetches each message's full raw MIME content and returns the base64url-decoded body.

When True, the return value is a dict with both the formatted thread content AND structured ownership analysis (last sender, ball-in-court verdict, per-sender message counts, participants). Defaults to False, in which case the existing string return shape is preserved.

A list of Gmail thread IDs to retrieve. The function will automatically batch requests in chunks of 25.

The user's Google email address. Required.

Body output format. 'text' (default) returns plaintext (HTML converted to text as fallback). 'html' returns the raw HTML body as-is without conversion. 'raw' fetches each message's full raw MIME content and returns the base64url-decoded body.

Optional filter string using the Chat API filter syntax. Supports createTime and thread.name. Examples: 'createTime > "2026-03-18T00:00:00-03:00"' 'createTime > "2026-03-18T00:00:00-03:00" AND createTime < "2026-03-19T00:00:00-03:00"' 'thread.name = spaces/X/threads/Y'

The user's Google email address. Required.

The ID of the presentation.

The object ID of the page/slide to retrieve.

The user's Google email address. Required.

The ID of the presentation.

The object ID of the page/slide.

Size of thumbnail ("LARGE", "MEDIUM", "SMALL"). Defaults to "MEDIUM".

The user's Google email address. Required.

The ID of the presentation to retrieve.

User's email address

The script project ID

Name of the file to retrieve

User's email address

The script project ID

Granularity of metrics - "DAILY" or "WEEKLY"

User's email address

The script project ID

The user's Google email address. Required.

The user's Google email address. Required.

The ID of the spreadsheet to get info for. Required.

The user's Google email address. Required.

The ID of the task list containing the task.

The ID of the task to retrieve.

The user's Google email address. Required.

The ID of the task list to retrieve.

User's email address

The script project ID

The version number to retrieve (1, 2, 3, etc.)

The user's Google email address. Required.

The name for the new Google Doc (extension will be ignored).

Text content for text-based formats. Use only for short snippets or content already in memory.

Local file path or file:// URL for any supported format (MD, TXT, HTML, DOCX, ODT, RTF). Appropriate for larger files than content, but file_path may still load the file into memory or perform non-streaming reads. Avoid very large files that could exceed memory or time limits; use streaming/chunked uploads or an alternative API for huge files.

Remote URL to fetch the file from (http/https).

Source format hint ('md', 'markdown', 'docx', 'txt', 'html', 'rtf', 'odt'). Auto-detected from file_name extension if not provided.

The ID of the parent folder. Defaults to 'root'.

The user's Google email address. Required.

The name for the new Google Sheets spreadsheet (extension will be ignored).

Text content for text-based formats (CSV, TSV). Use only for short snippets or content already in memory.

Local file path or file:// URL for any supported format (XLSX, XLS, ODS, CSV, TSV). Appropriate for larger files than content, but file_path may still load the file into memory or perform non-streaming reads. Avoid very large files that could exceed memory or time limits; use streaming/chunked uploads or an alternative API for huge files.

Remote URL to fetch the spreadsheet from (http/https).

Source format hint ('xlsx', 'xls', 'ods', 'csv', 'tsv'). Auto-detected from file_name extension if not provided.

The ID of the parent folder. Defaults to 'root'.

The user's Google email address. Required.

The name for the new Google Slides presentation (extension will be ignored).

Local file path or file:// URL for any supported format (PPTX, PPT, ODP). Appropriate for larger files than content, but file_path may still load the file into memory or perform non-streaming reads. Avoid very large files that could exceed memory or time limits; use streaming/chunked uploads or an alternative API for huge files.

Remote URL to fetch the presentation from (http/https).

Source format hint ('pptx', 'ppt', 'odp'). Auto-detected from file_name extension if not provided.

The ID of the parent folder. Defaults to 'root'.

User's Google email address

ID of the document to update

Type of element to insert ("table", "list", "page_break")

Position to insert element (0-based)

Number of rows for table (required for table)

Number of columns for table (required for table)

Type of list ("UNORDERED", "ORDERED") (required for list)

Initial text content for list items

User's Google email address

ID of the document to update

Drive file ID or public image URL

Position to insert image (0-based)

Image width in points (optional)

Image height in points (optional)

User's Google email address

ID of the document to inspect

Whether to return detailed structure information

Optional ID of the tab to inspect. If not provided, inspects main document.

The user's Google email address. Required.

The user's Google email address. Required.

Maximum number of groups to return (default: 100, max: 1000).

Token for pagination.

The user's Google email address. Required.

Maximum number of contacts to return (default: 100, max: 1000).

Token for pagination.

Sort order: "LAST_MODIFIED_ASCENDING", "LAST_MODIFIED_DESCENDING", "FIRST_NAME_ASCENDING", or "LAST_NAME_ASCENDING".

User's email address

The script project ID

The user's Google email address. Required.

The ID of the Google Drive folder. Defaults to 'root'. For a shared drive, this can be the shared drive's ID to list its root, or a folder ID within that shared drive.

The maximum number of items to return. Defaults to 100.

Page token from a previous response's nextPageToken to retrieve the next page of results.

ID of the shared drive. If provided, the listing is scoped to this drive.

Whether items from all accessible shared drives should be included if `drive_id` is not set. Defaults to True.

Corpus to query ('user', 'drive', 'allDrives'). If `drive_id` is set and `corpora` is None, 'drive' is used. If None and no `drive_id`, API defaults apply.

Restrict results to a specific file type. Accepts a friendly name ('folder', 'document'/'doc', 'spreadsheet'/'sheet', 'presentation'/'slides', 'form', 'drawing', 'pdf', 'shortcut', 'script', 'site', 'jam'/'jamboard') or any raw MIME type string (e.g. 'application/pdf'). Defaults to None (all types).

Whether to include size, modified time, and link in results. Defaults to True.

Sort order. Comma-separated list of sort keys with optional 'desc' modifier. Valid keys: 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. Example: 'modifiedTime desc' or 'folder,modifiedTime desc,name'. Defaults to None (Drive API default ordering).

What to list. Use "items" for folder contents or "shared_drives" for shared drive containers. Defaults to "items".

Shared drive query used only when resource_type="shared_drives", e.g. "name contains 'Engineering'".

When resource_type="shared_drives", include principals with the organizer role. This costs one extra permissions.list API call per shared drive returned. Defaults to False.

The user's Google email address. Required.

The ID of the form.

Maximum number of responses to return. Defaults to 10.

Token for retrieving next page of results.

The user's Google email address. Required.

The user's Google email address. Required.

User's email address

Number of results (default: 50)

Optional filter by script ID

User's email address

Number of results per page (default: 50)

Token for pagination (optional)

The user's Google email address. Required.

The ID of the spreadsheet. Required.

The user's Google email address. Required.

Maximum number of spreadsheets to return. Defaults to 25.

The user's Google email address. Required.

Maximum number of task lists to return (default: 1000, max: 1000).

Token for pagination.

The user's Google email address. Required.

The ID of the task list to retrieve tasks from.

Maximum number of tasks to return. (default: 20, max: 10000).

Token for pagination.

Whether to include completed tasks (default: True). Note that show_hidden must also be true to show tasks completed in first party clients, such as the web UI and Google's mobile apps.

Whether to include deleted tasks (default: False).

Whether to include hidden tasks (default: False).

Whether to include assigned tasks (default: False).

Upper bound for completion date (RFC 3339 timestamp).

Lower bound for completion date (RFC 3339 timestamp).

Upper bound for due date (RFC 3339 timestamp).

Lower bound for due date (RFC 3339 timestamp).

Lower bound for last modification time (RFC 3339 timestamp).

User's email address

The script project ID

The user's Google email address. Required.

The ID of the spreadsheet. Required.

The operation to perform. Must be one of "add", "update", or "delete".

A1-style range (optionally with sheet name). Required for "add". Optional for "update" (preserves existing ranges if omitted). Not used for "delete".

Sheets condition type (e.g., NUMBER_GREATER, TEXT_CONTAINS, DATE_BEFORE, CUSTOM_FORMULA). Required for "add". Optional for "update" (preserves existing type if omitted).

Values for the condition; accepts a list or a JSON string representing a list. Depends on condition_type. Used by "add" and "update".

Hex background color to apply when condition matches. Used by "add" and "update".

Hex text color to apply when condition matches. Used by "add" and "update".

0-based index of the rule. For "add", optionally specifies insertion position. Required for "update" and "delete".

List (or JSON list) of gradient points for a color scale. If provided, a gradient rule is created and boolean parameters are ignored. Used by "add" and "update".

Sheet name to locate the rule when range_name is omitted. Defaults to the first sheet. Used by "update" and "delete".

The user's Google email address. Required.

The action to perform: "create", "update", or "delete".

The contact ID. Required for "update" and "delete" actions.

First name (for create/update).

Last name (for create/update).

List of phone dicts {number, type?}. Supported types: mobile, work, home, main, workMobile, internal, other, etc. Use type="internal" for internal PBX/ATS short numbers (e.g. 250, 301) — stored as a standalone number without + prefix, displayed as "Internal: 250".

List of email dicts {address, type?}.

List of org dicts {name?, title?, department?, jobDescription?, type?}.

List of nickname dicts {value, type?}. Useful for bilingual contacts (e.g. Hebrew/English alternative forms). Android dialer and WhatsApp search both index nicknames, enabling cross-script lookup. Supported types: default, alternate_name, maiden_name, initials, other, etc.

List of URL dicts {value, type?}. Supported types: homepage, blog, profile, work, ftp, reservations, other, etc.

List of custom field dicts {key, value}. Useful for structured data like account numbers, IDs, or custom dates.

List of relation dicts {person, type?}. Supported types: spouse, child, parent, friend, manager, assistant, etc.

Additional notes (for create/update).

Street address (for create/update).

Birthday as 'YYYY-MM-DD', 'MM-DD' (no year), or 'clear'/'' to remove.

How to update phones on "update": "merge" (default), "replace", or "remove". merge = read-modify-write with dedup by canonicalForm/normalized value. replace = overwrite all phones with provided list. remove = delete phones matching provided numbers.

How to update emails on "update": "merge" (default), "replace", or "remove".

How to update orgs on "update": "merge" (default), "replace", or "remove".

How to update nicknames on "update": "merge" (default), "replace", or "remove".

How to update urls on "update": "merge" (default), "replace", or "remove". merge dedups by normalized URL (lowercased, trailing slash stripped).

How to update custom fields on "update": "merge" (default), "replace", or "remove". merge overrides value on matching key; new keys appended.

How to update relations on "update": "merge" (default), "replace", or "remove".

[DEPRECATED] Single phone number. Use phones=[{"number":..., "type":"mobile"}].

[DEPRECATED] Email address. Use emails=[{"address":..., "type":"other"}].

[DEPRECATED] Company name. Use organizations=[{"name":...}].

[DEPRECATED] Job title. Use organizations=[{"title":...}].

The user's Google email address. Required.

The action to perform: "create", "update", "delete", or "modify_members".

The contact group ID. Required for "update", "delete", and "modify_members" actions.

The group name. Required for "create" and "update" actions.

If True and action is "delete", also delete contacts in the group (default: False).

Contact IDs to add (for "modify_members").

Contact IDs to remove (for "modify_members").

The user's Google email address. Required.

The action to perform: "create", "update", or "delete".

List of contact dicts for "create" action. Each dict may contain: given_name, family_name, phones, emails, organizations, notes, address. Deprecated: phone, email, organization, job_title.

List of update dicts for "update" action. Each dict must contain contact_id and may contain the same fields as contacts.

List of contact IDs for "delete" action.

For "update" action — the single People API field to update across all contacts in this batch. Required. Must be one of: names, phoneNumbers, emailAddresses, organizations, nicknames, urls, userDefined, relations, biographies, addresses, birthdays. Using a single field per batch call prevents unintentional data loss from a union updateMask overwriting unrelated fields.

User's email address

Action to perform - "create", "update", or "delete"

The script project ID

The deployment ID (required for update and delete)

Deployment description (required for create and update)

Optional version description (for create only)

User's Google email address

ID of the document

Action to perform - "create", "rename", "delete", or "populate_from_markdown"

Tab ID (required for rename, delete, populate_from_markdown; use inspect_doc_structure to find IDs)

Tab title (required for create; used by rename)

Position index for new tab, 0-based among siblings (required for create)

Optional parent tab ID to nest under (create only)

Markdown source to render (populate_from_markdown only)

Clear tab body before inserting markdown (default True)

The user's Google email address. Required.

The ID of the file or folder. Required.

The access management action to perform. Required. One of: - "grant": Share with a single user, group, domain, or anyone. - "grant_batch": Share with multiple recipients in one call. - "update": Modify an existing permission (role or expiration). - "revoke": Remove an existing permission. - "transfer_owner": Transfer file ownership to another user.

Email address (user/group), domain name (domain), or omit for 'anyone'. Used by "grant".

Permission role -- 'reader', 'commenter', or 'writer'. Used by "grant" (defaults to 'reader') and "update".

Type of sharing -- 'user', 'group', 'domain', or 'anyone'. Used by "grant". Defaults to 'user'.

The permission ID to modify or remove. Required for "update" and "revoke" actions.

List of recipient objects for "grant_batch". Each should have: email (str), role (str, optional), share_type (str, optional), expiration_time (str, optional). For domain shares use 'domain' field instead of 'email'.

Whether to send notification emails. Defaults to True. Used by "grant" and "grant_batch".

Custom notification email message. Used by "grant" and "grant_batch".

Expiration in RFC 3339 format (e.g., "2025-01-15T00:00:00Z"). Used by "grant" and "update".

For 'domain'/'anyone' shares, whether the file appears in search. Used by "grant".

Email of the new owner. Required for "transfer_owner".

Move file to the new owner's My Drive root. Defaults to False. Used by "transfer_owner".

The user's Google email address. Required.

Action to perform - "create", "update", "delete", or "rsvp".

Event title (required for create).

Start time in RFC3339 format (required for create).

End time in RFC3339 format (required for create).

Event ID (required for update and delete).

Calendar ID (default: 'primary').

Event description.

Event location.

Attendee email addresses or objects.

Timezone (e.g., "America/New_York").

List of Google Drive file URLs or IDs to attach.

Whether to add/remove native Google Meet.

Raw Google Calendar `conferenceData` payload to attach a third-party conference (Zoom/Webex/Teams add-on). Use this for full control; mutually exclusive with the conference_provider helper params and with add_google_meet. (create/update only)

Higher-level helper: third-party provider name (e.g. "zoom", "webex", "teams"). Requires conference_uri. The MCP builds the addOn `conferenceData` block internally. (create/update only)

Join URL for the third-party conference (e.g. "https://zoom.us/j/123456789"). Required when conference_provider is set.

Optional passcode for the third-party conference.

Optional provider-side conference/meeting ID.

Custom reminder objects.

Whether to use default reminders.

"opaque" (busy) or "transparent" (free).

"default", "public", "private", or "confidential".

Event color ID (1-11, update only).

RFC5545 recurrence rules for a recurring event, e.g. ["RRULE:FREQ=WEEKLY;COUNT=10"].

Whether attendees can modify.

Whether attendees can invite others.

Whether attendees can see other guests.

RSVP response — "accepted", "declined", "tentative", or "needsAction" (rsvp action only).

Optional message to include with the RSVP response (rsvp action only).

Notification behavior for create, update, delete, and rsvp — "all" (default), "externalOnly", or "none".

The user's Google email address. Required.

Action to perform - "create", "list", "update", or "delete".

Start date/time. Use 'YYYY-MM-DD' for full-day or RFC3339 for partial-day (e.g., '2024-04-05T09:00:00Z'). Date-only values are auto-converted to dateTime (midnight-to-midnight). Required for create.

End date/time (exclusive). Same format as start_time. For a single full day on April 5, use start_time='2026-04-05' and end_time='2026-04-06'. Required for create.

Display text on the calendar. Defaults to "Focus Time".

Event description. Useful for adding context about what the focus time is for.

How to handle conflicting invitations. One of: "declineAllConflictingInvitations" (default), "declineOnlyNewConflictingInvitations", "declineNone".

Message included when auto-declining invitations.

Google Chat status during the focus time. Supports "doNotDisturb" (default) and "available".

RFC5545 recurrence rules for a recurring Focus Time series, e.g. ["RRULE:FREQ=WEEKLY;COUNT=10"].

Timezone for the event (e.g., "America/New_York", "Europe/London"). Required when using date-only values or dateTime values without an explicit UTC offset.

For "list" action: start of time range. Defaults to current time. Recurring series are expanded into individual instances in the requested range.

For "list" action: end of time range.

For "list" action: maximum events to return. Defaults to 10.

Event ID. Required for "update" and "delete" actions.

Calendar ID. Defaults to 'primary'. Focus Time status events live on primary calendars, so use 'primary' or a user's primary calendar ID/email rather than a secondary calendar ID.

The user's Google email address. Required.

Action to perform - "create" or "delete".

Filter criteria object (required for create).

Filter action object (required for create). Named 'filter_action' to avoid shadowing the 'action' parameter.

ID of the filter to delete (required for delete).

The user's Google email address. Required.

Action to perform on the label.

Label name. Required for create, optional for update.

Label ID. Required for update and delete operations.

Whether the label is shown in the label list.

Whether the label is shown in the message list.

The user's Google email address. Required.

Action to perform - "create", "list", "update", or "delete".

Start date/time. Use 'YYYY-MM-DD' for full-day or RFC3339 for partial-day (e.g., '2024-04-05T09:00:00Z'). Date-only values are auto-converted to dateTime (midnight-to-midnight). Required for create.

End date/time (exclusive). Same format as start_time. For a single full day on April 5, use start_time='2026-04-05' and end_time='2026-04-06'. Required for create.

Display text on the calendar. Defaults to "Out of Office".

How to handle conflicting invitations. One of: "declineAllConflictingInvitations" (default), "declineOnlyNewConflictingInvitations", "declineNone".

Message included when auto-declining invitations.

RFC5545 recurrence rules for a recurring Out of Office series, e.g. ["RRULE:FREQ=WEEKLY;COUNT=10"].

Timezone for the event (e.g., "America/New_York", "Europe/London"). Required when using date-only values or dateTime values without an explicit UTC offset.

For "list" action: start of time range. Defaults to current time. Recurring series are expanded into individual instances in the requested range.

For "list" action: end of time range.

For "list" action: maximum events to return. Defaults to 10.

Event ID. Required for "update" and "delete" actions.

Calendar ID. Defaults to 'primary'. Out of Office status events live on primary calendars, so use 'primary' or a user's primary calendar ID/email rather than a secondary calendar ID.

The user's Google email address. Required.

The action to perform. Must be one of: "create", "update", "delete", "move".

The ID of the task list. Required for all actions.

The ID of the task. Required for "update", "delete", and "move" actions.

The title of the task. Required for "create", optional for "update".

Notes/description for the task. Used by "create" and "update" actions.

Task status ("needsAction" or "completed"). Used by "update" action.

Due date in RFC 3339 format (e.g., "2024-12-31T23:59:59Z"). Used by "create" and "update" actions.

Parent task ID (for subtasks). Used by "create" and "move" actions.

Previous sibling task ID (for positioning). Used by "create" and "move" actions.

Destination task list ID (for moving between lists). Used by "move" action.

The user's Google email address. Required.

The action to perform. Must be one of: "create", "update", "delete", "clear_completed".

The ID of the task list. Required for "update", "delete", and "clear_completed" actions.

The title for the task list. Required for "create" and "update" actions.

User's Google email address

ID of the document to update

Start position for operation using Docs API indices from inspect_doc_structure. For the main body, 0 is also accepted as an alias for the first writable position.

End position for text replacement/formatting (if not provided with text, text is inserted)

New text to insert or replace with (optional - can format existing text without changing it)

Optional document tab ID to target

Optional header/footer/footnote segment ID to target

Insert text at the end of the targeted segment instead of start_index

Whether to make text bold (True/False/None to leave unchanged)

Whether to make text italic (True/False/None to leave unchanged)

Whether to underline text (True/False/None to leave unchanged)

Whether to strike through text (True/False/None to leave unchanged)

Font size in points

Font family name (e.g., "Arial", "Times New Roman")

Font weight (100-900 in steps of 100; requires font_family)

Foreground text color (#RRGGBB)

Background/highlight color (#RRGGBB)

Hyperlink URL (http/https)

Remove hyperlink from the target range

One of NONE, SUPERSCRIPT, SUBSCRIPT

Whether to apply small caps

The user's Google email address. Required.

The ID of the message to modify.

List of label IDs to add to the message.

List of label IDs to remove from the message.

The user's Google email address. Required.

The ID of the spreadsheet. Required.

The range to modify (e.g., "Sheet1!A1:D10", "A1:D10"). Required.

2D array of values to write/update. Can be a JSON string or Python list. Required unless clear_values=True.

How to interpret input values ("RAW" or "USER_ENTERED"). Defaults to "USER_ENTERED".

If True, clears the range instead of writing values. Defaults to False.

The user's Google email address. Required.

The ID of the spreadsheet. Required.

Name of the sheet to move rows from. Required.

First row to move (1-based, inclusive). Required.

Last row to move (1-based, inclusive). Required.

Name of the sheet to move rows to. Required.

The user's Google email address. Required.

The start of the interval for the query in RFC3339 format (e.g., '2024-05-12T10:00:00Z' or '2024-05-12').

The end of the interval for the query in RFC3339 format (e.g., '2024-05-12T18:00:00Z' or '2024-05-12').

List of calendar identifiers to query. If not provided, queries the primary calendar. Use 'primary' for the user's primary calendar or specific calendar IDs obtained from `list_calendars`.

Maximum number of calendar identifiers to be provided for a single group. Optional. An error is returned for a group with more members than this value. Maximum value is 100.

Maximum number of calendars for which FreeBusy information is to be provided. Optional. Maximum value is 50.

The user's Google email address. Required.

The ID of the spreadsheet. Required.

The range to read (e.g., "Sheet1!A1:D10", "A1:D10"). Defaults to "A1:Z1000".

If True, also fetch hyperlink metadata for the range. Defaults to False to avoid expensive includeGridData requests.

If True, also fetch cell notes for the range. Defaults to False to avoid expensive includeGridData requests.

If True, also fetch raw formula strings for cells that contain formulas. Useful for identifying cross-sheet references before writing back to a range. Defaults to False to avoid an extra API request.

The user's Google email address. Required.

The ID of the spreadsheet. Required.

Sheet name to target. Defaults to the first sheet if not provided.

Dict mapping column letters to pixel widths. Example: {"A": 200, "C": 300}. Can be a JSON string or Python dict.

Dict mapping 1-based row numbers to pixel heights. Example: {"1": 40, "3": 60}. Can be a JSON string or Python dict.

List of column letters to auto-resize to fit content. Example: ["A", "B"].

List of 1-based row numbers to auto-resize to fit content. Example: [1, 2].

Number of rows to freeze from the top. Use 0 to unfreeze all rows.

Number of columns to freeze from the left. Use 0 to unfreeze all columns.

List of column letters to hide. Example: ["C", "D"].

List of column letters to unhide. Example: ["C", "D"].

List of 1-based row numbers to hide. Example: [3, 4].

List of 1-based row numbers to unhide. Example: [3, 4].

Number of rows to insert.

1-based row number to insert before. Appends to the end of the sheet if omitted.

Number of columns to insert.

Column letter to insert before (e.g. "C"). Appends to the end if omitted.

List of 1-based row numbers to delete. Example: [5, 6]. Best for non-contiguous rows.

Contiguous range of rows to delete, as "start:end" (1-based, inclusive). Example: "5:10" deletes rows 5 through 10. More efficient than delete_rows for large contiguous ranges.

List of column letters to delete. Example: ["E", "F"].

User's email address

The script project ID

Name of function to execute

Optional list of parameters to pass

Whether to run latest code vs deployed version

The user's Google email address. Required.

Search query string (searches names, emails, phone numbers).

Maximum number of results to return (default: 30, max: 30).

The user's Google email address. Required.

The search query. Required.

Number of results to return (1-10). Defaults to 10.

The index of the first result to return (1-based). Defaults to 1.

Safe search level. Defaults to "off".

Search for images if set to "image".

Restrict search to a specific site/domain.

Exclude ("e") or include ("i") site_search results.

Restrict results by date (e.g., "d5" for past 5 days, "m3" for past 3 months).

Filter by file type (e.g., "pdf", "doc").

Language code for results (e.g., "lang_en").

Country code for results (e.g., "countryUS").

List of sites/domains to restrict search to (e.g., ["example.com", "docs.example.com"]). When provided, results are limited to these sites.

The user's Google email address. Required.

The search query string. Supports Google Drive search operators. NOTE: Owner-based queries ('user@example.com' in owners) DO NOT WORK in Shared Drives because files are owned by the shared drive itself, not individual users. For recent files by a specific user in Shared Drives, search by modifiedTime and use order_by='modifiedTime desc' instead.

The maximum number of files to return. Defaults to 10.

Page token from a previous response's nextPageToken to retrieve the next page of results.

ID of the shared drive to search. If None, behavior depends on `corpora` and `include_items_from_all_drives`.

Whether shared drive items should be included in results. Defaults to True. This is effective when not specifying a `drive_id`.

Bodies of items to query (e.g., 'user', 'domain', 'drive', 'allDrives'). If 'drive_id' is specified and 'corpora' is None, it defaults to 'drive'. Otherwise, Drive API default behavior applies. Prefer 'user' or 'drive' over 'allDrives' for efficiency.

Restrict results to a specific file type. Accepts a friendly name ('folder', 'document'/'doc', 'spreadsheet'/'sheet', 'presentation'/'slides', 'form', 'drawing', 'pdf', 'shortcut', 'script', 'site', 'jam'/'jamboard') or any raw MIME type string (e.g. 'application/pdf'). Defaults to None (all types).

Whether to include size, modified time, and link in results. Defaults to True.

Sort order. Comma-separated list of sort keys with optional 'desc' modifier. Valid keys: 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. Example: 'modifiedTime desc' or 'folder,modifiedTime desc,name'. Defaults to None (Drive API default ordering).

The search query. Supports standard Gmail search operators.

The user's Google email address. Required.

The maximum number of messages to return. Defaults to 10.

Token for retrieving the next page of results. Use the next_page_token from a previous response.

Optional text to search for. If omitted, only time_filter is applied.

Optional space to restrict the search to.

Maximum number of messages to return per space.

Optional filter using Chat API createTime syntax. Examples: 'createTime > "2026-03-18T00:00:00-03:00"' 'createTime > "2026-03-18T00:00:00-03:00" AND createTime < "2026-03-19T00:00:00-03:00"'

Maximum number of spaces to search when space_id is not provided (default 10).

The user's Google email address. Required for authentication.

Recipient email address.

Email subject. Required when sending; optional when forwarding (defaults to 'Fwd: <original subject>').

Email body content (plain text or HTML). Required when sending. When forwarding, this is an optional note prepended above the quoted original.

Format of the body content (and of the prepended note when forwarding). Use 'plain' for plaintext or 'html' for HTML content.

Set to a Gmail message ID to forward that message instead of composing a new one. The original subject, body, and (optionally) attachments are carried over; 'body' becomes an optional note prepended to the forward.

When forwarding, whether to include the original message's attachments. Ignored unless forward_message_id is set.

Optional CC email address.

Optional BCC email address.

Optional sender display name (e.g., 'Peter Hartree'). If provided, the From header will be formatted as 'Name <email>'.

Optional 'Send As' alias email address. Must be configured in Gmail settings (Settings > Accounts > Send mail as). If not provided, uses the authenticated user's email.

Optional Gmail thread ID to reply within.

Optional RFC Message-ID of the message being replied to (e.g., '<message123@gmail.com>').

Optional chain of Message-IDs for proper threading.

Optional list of attachments. Each can have: "url" (fetch from URL — works with MCP attachment URLs from get_drive_file_download_url / get_gmail_attachment_content), OR "path" (file path, auto-encodes), OR "content" (standard base64, not urlsafe) + "filename". Optional "mime_type". Optional "content_id" (string) makes the attachment inline-rendered: it lands in a multipart/related part with `Content-ID: <content_id>` and `Content-Disposition: inline`, and the HTML body can reference it via `<img src="cid:<content_id>">` (RFC 2392). Without `content_id` the attachment is a regular multipart/mixed attachment. Example: [{"url": "https://host/attachments/abc-123", "filename": "report.pdf"}]

Whether to append the Gmail signature from Settings > Signature when available. Defaults to true.

Reply in a thread by app-defined key (creates thread if not found).

Reply in an existing thread by its resource name (e.g. spaces/X/threads/Y).

The user's Google email address. Required.

The ID of the file or folder. Required.

Control "anyone with the link" access for the file. - "off": Disable "anyone with the link" access for this file. - "reader": Anyone with the link can view. - "commenter": Anyone with the link can comment. - "writer": Anyone with the link can edit.

Whether editors can change permissions and share. If False, only the owner can share. Defaults to None (no change).

Whether viewers and commenters are prevented from copying, printing, or downloading. Defaults to None (no change).

The user's Google email address. Required.

The ID of the form to update publish settings for.

Whether the form is published and visible to responders. Defaults to True.

Whether the form accepts responses. Only takes effect when the form is published. Defaults to True.

User's Google email address

ID of the document to update

Type of section to create or update ("header" or "footer")

Text content for the header/footer

Type of header/footer ("DEFAULT", "FIRST_PAGE_ONLY", "EVEN_PAGE")

The user's Google email address. Required.

The ID of the file to update. Required.

New name for the file.

New description for the file.

New MIME type (note: changing type may require content upload).

Comma-separated folder IDs to add as parents.

Comma-separated folder IDs to remove from parents.

Whether to star/unstar the file.

Whether to move file to/from trash.

Whether editors can share the file.

Whether copying requires writer permission.

Custom key-value properties for the file.

New text content for text-based formats (markdown, TXT, HTML).

Local file path for binary formats (DOCX, ODT). Supports file:// URLs.

Remote http(s) URL to fetch new content from.

Source format hint for conversion (md, markdown, docx, txt, html, rtf, odt). Auto-detected when omitted. Provide at most one of content/file_path/file_url.

User's Google email address

Document ID to modify

Start position using Docs API indices from inspect_doc_structure. For the main body, 0 is also accepted as an alias for the first writable position.

End position (exclusive) - should cover the entire paragraph

Heading level 0-6 (0 = NORMAL_TEXT, 1 = H1, 2 = H2, etc.) Use for semantic document structure

Text alignment - 'START' (left), 'CENTER', 'END' (right), or 'JUSTIFIED'

Line spacing multiplier (1.0 = single, 1.5 = 1.5x, 2.0 = double)

First line indent in points (e.g., 36 for 0.5 inch)

Left/start indent in points

Right/end indent in points

Space above paragraph in points (e.g., 12 for one line)

Space below paragraph in points

Direct named style type - 'NORMAL_TEXT', 'TITLE', 'SUBTITLE', 'HEADING_1' through 'HEADING_6'. Mutually exclusive with heading_level.

Optional document tab ID to target

Optional header/footer/footnote segment ID to target

Paragraph direction - 'LEFT_TO_RIGHT' or 'RIGHT_TO_LEFT'

Keep all lines of the paragraph together

Keep the paragraph with the next paragraph

Avoid widows/orphans for the paragraph

Start the paragraph on a new page

'NEVER_COLLAPSE' or 'COLLAPSE_LISTS'

Paragraph shading/background color (#RRGGBB)

Create a list from existing paragraphs ('UNORDERED' for bullets, 'ORDERED' for numbers, 'CHECKBOX' for checklists)

Nesting level for lists (0-8, where 0 is top level, default is 0) Use higher levels for nested/indented list items

Optional explicit Google Docs bullet preset

User's email address

The script project ID

List of file objects with name, type, and source