Google Workspace (DWD) connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Set up the connector

   Register your Google Workspace (DWD) credentials with Scalekit so it can authenticate requests on your behalf. You do this once per environment.

   Dashboard setup steps

   Register your Scalekit environment with the Google Workspace (DWD) connector so Scalekit can act on behalf of any user in your Google Workspace domain. Unlike OAuth connectors, DWD uses a service account — no per-user login flows are required.

   1. Create a connection in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Google Workspace (DWD) and click Create.

      • Under Scopes, add each Google API scope your agent needs. Enter the full scope URI, for example:

        • https://www.googleapis.com/auth/gmail.readonly
        • https://www.googleapis.com/auth/calendar
        • https://www.googleapis.com/auth/drive

        See the Google OAuth 2.0 Scopes reference for the full list.

   2. Create a GCP service account

      • Go to Google Cloud Console → IAM & Admin → Service Accounts.
      • Click + Create Service Account, enter a name and description, and click Create and Continue.
      • Skip the optional role and user access steps and click Done.

   3. Download the service account JSON key

      • In Google Cloud Console, go to IAM & Admin → Service Accounts and click your service account.
      • Go to the Keys tab → Add Key → Create new key.
      • Select JSON and click Create. The key file downloads automatically.

   4. Add the service account JSON in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections and open the connection you created in step 1.
      • Paste the full contents of the downloaded JSON key file into the Service Account JSON field. Treat this JSON key as a secret credential — restrict access to the connection settings and rotate or revoke the key immediately if it is exposed.
      • Click Save.

   Authorize the service account in Google Admin

   The admin of the Google Workspace organization you want to connect to must complete these steps to authorize your service account.

   Requires Google Workspace super admin access

   These steps must be completed by a super admin of the target Google Workspace organization — not in your GCP account.

   1. Open API controls in Google Admin

      • Sign in to Google Admin console as a super admin.
      • Go to Security → Access and data control → API controls.
      • Click Manage Domain Wide Delegation → Add new.

   2. Authorize the service account

      • In Client ID, enter the Unique ID of the service account created during setup (visible in GCP Console → IAM & Admin → Service Accounts → click the service account → Details tab).
      • In OAuth scopes, enter the scopes comma-separated — these must match exactly what was configured in the Scalekit connection. For example:
        • https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/calendar, https://www.googleapis.com/auth/drive
      • Click Authorize.

   You can now impersonate any user in that workspace with your service account via Scalekit connected accounts.

What you can do

Connect this agent connector to let your agent:

• Read and search emails — fetch messages, threads, and attachments from any Gmail label or inbox
• Send and manage emails — compose messages, manage drafts, and modify labels on Gmail messages
• Manage Google Drive files — share, move, copy, and query activity on files and folders in Google Drive
• Access Google Calendar — read, create, and manage calendar events across a user’s calendars
• Manage Google Vault — list matters and manage legal holds in Google Vault
• Administer user settings — update vacation auto-reply settings and other Gmail account configurations

Authentication

This connector uses Service Account with Domain-Wide Delegation (DWD). You create a GCP service account, grant it domain-wide delegation in Google Admin, and provide Scalekit with the service account JSON key. Scalekit then impersonates any user in your Google Workspace domain on demand — no per-user OAuth redirects required.

Common workflows

Create a connected account

Before executing tools, create a connected account for each Google Workspace user you want to impersonate. Pass the user’s email as subject — this tells Scalekit which Workspace user the service account should act as. The identifier is your application’s ID for that user.

Admin authorization required

The Google Workspace admin must whitelist your service account Client ID and scopes before this call will succeed. See the Create a connected account steps above.

Python

response = scalekit_client.actions.create_connected_account(
    # connection_name: the name of the connection you created in the setup step above
    connection_name='googledwd',
    identifier='user_123',
    authorization_details={
        "google_dwd": {
            # subject: the Google Workspace user you want to impersonate
            "subject": "alice@yourcompany.com",
        }
    },
)
print(response.connected_account.id)
print(response.connected_account.status)

Execute a tool

Use the identifier you set when creating the connected account. Scalekit resolves the impersonated Workspace user from that mapping.

Python

response = scalekit_client.actions.execute_tool(
    # connection_name: the name of the connection you created in the setup step above
    connection_name='googledwd',
    identifier='user_123',
    tool_name='googledwd_fetch_mails',
    tool_input={
        "max_results": 5,
        "format": "metadata",
        "include_spam_trash": False,
    },
)
print(response)

Create a connected account

Before executing tools, create a connected account for each Google Workspace user you want to impersonate. Pass the user’s email as subject — this tells Scalekit which Workspace user the service account should act as. The identifier is your application’s ID for that user.

Admin authorization required

The Google Workspace admin must whitelist your service account Client ID and scopes before this call will succeed. See the Set up the connector steps above.

Python

response = scalekit_client.actions.create_connected_account(
    # connection_name: the name of the connection you created in the setup step above
    connection_name='googledwd',
    identifier='user_123',
    authorization_details={
        "google_dwd": {
            # subject: the Google Workspace user you want to impersonate
            "subject": "alice@yourcompany.com",
        }
    },
)
print(response.connected_account.id)
print(response.connected_account.status)

Execute tools

Execute a tool

Use the identifier you set when creating the connected account. Scalekit resolves the impersonated Workspace user from that mapping.

Python

response = scalekit_client.actions.execute_tool(
    # connection_name: the name of the connection you created in the setup step above
    connection_name='googledwd',
    identifier='user_123',
    tool_name='googledwd_fetch_mails',
    tool_input={
        "max_results": 5,
        "format": "metadata",
        "include_spam_trash": False,
    },
)
print(response)

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

googledwd_append_values#Append rows of data to a Google Sheets spreadsheet. Data is added after the last row with existing content in the specified range.5 params▾

Append rows of data to a Google Sheets spreadsheet. Data is added after the last row with existing content in the specified range.

NameTypeRequiredDescription

rangestringrequiredThe A1 notation range to append data to (e.g. Sheet1!A1)

spreadsheet_idstringrequiredThe ID of the spreadsheet to append data to

valuesarrayrequired2D array of values to append. Each inner array is a row.

insert_data_optionstringoptionalHow the input data should be inserted. Options: INSERT_ROWS (inserts new rows), OVERWRITE (overwrites existing data). Default: OVERWRITE

value_input_optionstringoptionalHow input data should be interpreted. Options: RAW (literal values), USER_ENTERED (as if typed in UI, parses formulas/dates). Default: USER_ENTERED

googledwd_clear_values#Clear all values in a specified range of a Google Sheets spreadsheet. Formatting is preserved; only the cell values are cleared.2 params▾

Clear all values in a specified range of a Google Sheets spreadsheet. Formatting is preserved; only the cell values are cleared.

NameTypeRequiredDescription

rangestringrequiredThe A1 notation range to clear (e.g. Sheet1!A1:D10)

spreadsheet_idstringrequiredThe ID of the spreadsheet to clear values in

googledwd_complete_task#Mark a task as completed in Google Tasks. Sets the task status to 'completed'. Uses DWD service account credentials.4 params▾

Mark a task as completed in Google Tasks. Sets the task status to 'completed'. Uses DWD service account credentials.

NameTypeRequiredDescription

task_idstringrequiredThe ID of the task to mark as completed.

task_list_idstringrequiredThe ID of the task list containing the task.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_copy_file#Create a copy of an existing file in Google Drive. Optionally rename the copy, place it in a different folder, or add a description. Uses DWD service account credentials.6 params▾

Create a copy of an existing file in Google Drive. Optionally rename the copy, place it in a different folder, or add a description. Uses DWD service account credentials.

NameTypeRequiredDescription

file_idstringrequiredID of the file to copy

descriptionstringoptionalOptional description for the copied file

namestringoptionalName for the copied file. If omitted, the copy is named 'Copy of <original name>'.

parent_folder_idstringoptionalID of the destination folder for the copy. If omitted, the copy is placed in the same folder as the original.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_chat_message#Send a new text message to a Google Chat space. Optionally reply in an existing thread using a thread key. Uses DWD service account credentials.6 params▾

Send a new text message to a Google Chat space. Optionally reply in an existing thread using a thread key. Uses DWD service account credentials.

NameTypeRequiredDescription

space_namestringrequiredResource name of the Chat space to post the message to (e.g., 'spaces/AAAABBBBCCCC').

textstringrequiredPlain text body of the message to send.

request_idstringoptionalUnique client-assigned request ID to deduplicate messages (e.g., a UUID). If a message with the same request ID already exists, it is returned instead of creating a new one.

schema_versionstringoptionalOptional schema version to use for tool execution

thread_keystringoptionalThread key to reply in an existing thread. If the thread does not exist, a new thread is created (falls back to new thread).

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_contact#Create a new contact in Google People (Contacts). Provide at minimum a given name; optionally supply family name, email, phone number, organization, job title, and notes. Uses DWD service account credentials.9 params▾

Create a new contact in Google People (Contacts). Provide at minimum a given name; optionally supply family name, email, phone number, organization, job title, and notes. Uses DWD service account credentials.

NameTypeRequiredDescription

given_namestringrequiredGiven (first) name of the contact. Required.

emailstringoptionalEmail address for the new contact (e.g., jane@example.com).

family_namestringoptionalFamily (last) name of the contact.

job_titlestringoptionalJob title of the contact within their organization.

notesstringoptionalFree-text notes or biography to associate with the contact.

organizationstringoptionalOrganization (company) name for the contact.

phone_numberstringoptionalPhone number for the contact (e.g., +1-555-555-5555).

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_document#Create a new blank Google Doc with an optional title. Returns the new document's ID and metadata.3 params▾

Create a new blank Google Doc with an optional title. Returns the new document's ID and metadata.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

titlestringoptionalTitle of the new document

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_draft#Create a new draft email in Gmail for the authenticated user. Constructs a MIME message and saves it as a draft. Supports plain text and HTML content types, CC, BCC, and threading. Uses DWD service account credentials.9 params▾

Create a new draft email in Gmail for the authenticated user. Constructs a MIME message and saves it as a draft. Supports plain text and HTML content types, CC, BCC, and threading. Uses DWD service account credentials.

NameTypeRequiredDescription

bodystringrequiredThe body content of the draft email. Provide plain text or HTML depending on the content_type field. Example: 'Hello, this is my draft message.'

subjectstringrequiredThe subject line of the draft email. Example: 'Meeting Follow-up'.

tostringrequiredThe recipient email address(es) for the draft. Provide a single address or comma-separated list. Example: 'recipient@example.com' or 'a@example.com,b@example.com'.

bccstringoptionalBCC recipients for the draft email. Provide a comma-separated list of email addresses, e.g., bcc1@example.com,bcc2@example.com. Optional.

ccstringoptionalCC recipients for the draft email. Provide a comma-separated list of email addresses, e.g., cc1@example.com,cc2@example.com. Optional.

content_typestringoptionalThe MIME content type for the email body. Use 'text/plain' for plain text or 'text/html' for HTML content. Defaults to 'text/plain'.

schema_versionstringoptionalOptional schema version to use for tool execution

thread_idstringoptionalThe Gmail thread ID to associate this draft with an existing conversation. If provided, the draft will be part of that thread. Example: '17a1b2c3d4e5f6g7'.

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_event#Create a new event in a connected Google Calendar account. Supports meeting links, recurrence, attendees, and more. Uses DWD service account credentials.20 params▾

Create a new event in a connected Google Calendar account. Supports meeting links, recurrence, attendees, and more. Uses DWD service account credentials.

NameTypeRequiredDescription

start_datetimestringrequiredEvent start time in RFC3339 format

summarystringrequiredEvent title/summary

attendees_emailsarrayoptionalAttendee email addresses

calendar_idstringoptionalCalendar ID to create the event in

create_meeting_roombooleanoptionalGenerate a Google Meet link for this event

descriptionstringoptionalOptional event description

event_duration_hourintegeroptionalDuration of event in hours

event_duration_minutesintegeroptionalDuration of event in minutes

event_typestringoptionalEvent type for display purposes

guests_can_invite_othersbooleanoptionalAllow guests to invite others

guests_can_modifybooleanoptionalAllow guests to modify the event

guests_can_see_other_guestsbooleanoptionalAllow guests to see each other

locationstringoptionalLocation of the event

recurrencearrayoptionalRecurrence rules (iCalendar RRULE format)

schema_versionstringoptionalOptional schema version to use for tool execution

send_updatesbooleanoptionalSend update notifications to attendees

timezonestringoptionalTimezone for the event (IANA time zone identifier)

tool_versionstringoptionalOptional tool version to use for execution

transparencystringoptionalCalendar transparency (free/busy)

visibilitystringoptionalVisibility of the event

googledwd_create_filter#Create a new email filter for the authenticated Gmail account. Specify criteria (sender, recipient, subject, query, or attachment) and actions (apply labels, forward, archive, star, trash, mark as read, etc.). At least one criteria field should be provided. Uses DWD service account credentials.17 params▾

Create a new email filter for the authenticated Gmail account. Specify criteria (sender, recipient, subject, query, or attachment) and actions (apply labels, forward, archive, star, trash, mark as read, etc.). At least one criteria field should be provided. Uses DWD service account credentials.

NameTypeRequiredDescription

add_label_idsarrayoptionalList of Gmail label IDs to apply to matching messages (e.g., ['Label_123', 'STARRED']). Use the List Labels tool to find valid label IDs.

forwardstringoptionalEmail address to forward matching messages to. The address must already be configured as a forwarding address in the Gmail account.

fromstringoptionalSender email address or domain to match in the filter criteria (e.g., 'alerts@github.com' or '@newsletter.com').

has_attachmentbooleanoptionalIf true, only match messages that have at least one attachment.

querystringoptionalGmail search query string to match messages using Gmail's search syntax (e.g., 'larger:10M', 'is:important').

remove_label_idsarrayoptionalList of Gmail label IDs to remove from matching messages (e.g., ['INBOX'] to archive, ['UNREAD'] to mark as read).

schema_versionstringoptionalOptional schema version to use for tool execution

should_always_mark_importantbooleanoptionalIf true, always mark matching messages as important regardless of Gmail's automatic importance detection.

should_archivebooleanoptionalIf true, skip the inbox for matching messages (equivalent to adding the 'Archive' action).

should_mark_readbooleanoptionalIf true, automatically mark matching messages as read.

should_never_mark_importantbooleanoptionalIf true, never mark matching messages as important, overriding Gmail's automatic importance detection.

should_never_spambooleanoptionalIf true, never send matching messages to the Spam folder.

should_starbooleanoptionalIf true, automatically star matching messages.

should_trashbooleanoptionalIf true, automatically move matching messages to the Trash.

subjectstringoptionalSubject line text to match in the filter criteria (e.g., '[GitHub]' or 'Invoice').

tostringoptionalRecipient email address to match in the filter criteria (e.g., 'team@example.com').

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_folder#Create a new folder in Google Drive. Optionally place it inside a parent folder and add a description. Uses DWD service account credentials.5 params▾

Create a new folder in Google Drive. Optionally place it inside a parent folder and add a description. Uses DWD service account credentials.

NameTypeRequiredDescription

namestringrequiredName of the new folder

descriptionstringoptionalOptional description for the new folder

parent_folder_idstringoptionalID of the parent folder to create this folder inside. If omitted, the folder is created in the root of My Drive.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_form#Create a new Google Form with a title and optional document title. Returns the new form's ID and metadata.2 params▾

Create a new Google Form with a title and optional document title. Returns the new form's ID and metadata.

NameTypeRequiredDescription

titlestringrequiredThe title of the form shown to respondents

document_titlestringoptionalThe title of the document shown in Google Drive (defaults to the form title if not provided)

googledwd_create_meet_space#Create a new Google Meet meeting space. Optionally configure access type and entry point access restrictions. Returns the meeting URI and space details. Uses DWD service account credentials.4 params▾

Create a new Google Meet meeting space. Optionally configure access type and entry point access restrictions. Returns the meeting URI and space details. Uses DWD service account credentials.

NameTypeRequiredDescription

access_typestringoptionalAccess type for the meeting space. One of: 'OPEN' (anyone with link), 'TRUSTED' (domain users), 'RESTRICTED' (only invited participants).

entry_point_accessstringoptionalWho can use entry points to join. One of: 'ALL' (anyone), 'CREATOR_APP_ONLY' (only the creating app's users).

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_presentation#Create a new Google Slides presentation with an optional title.3 params▾

Create a new Google Slides presentation with an optional title.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

titlestringoptionalTitle of the new presentation

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_spreadsheet#Create a new Google Sheets spreadsheet with an optional title and initial sheet configuration. Returns the new spreadsheet ID and metadata.6 params▾

Create a new Google Sheets spreadsheet with an optional title and initial sheet configuration. Returns the new spreadsheet ID and metadata.

NameTypeRequiredDescription

localestringoptionalLocale of the spreadsheet

schema_versionstringoptionalOptional schema version to use for tool execution

sheetsarrayoptionalInitial sheets to include in the spreadsheet

time_zonestringoptionalTime zone for the spreadsheet

titlestringoptionalTitle of the new spreadsheet

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_task#Create a new task in a specified Google Tasks task list. Supports setting a title, notes, due date, and initial status. Uses DWD service account credentials.7 params▾

Create a new task in a specified Google Tasks task list. Supports setting a title, notes, due date, and initial status. Uses DWD service account credentials.

NameTypeRequiredDescription

task_list_idstringrequiredThe ID of the task list in which to create the task.

titlestringrequiredTitle of the new task.

duestringoptionalDue date and time of the task in RFC3339 datetime format (e.g., 2025-08-15T17:00:00Z). Note: the time portion is ignored by the Google Tasks API; only the date is used.

notesstringoptionalAdditional notes or description for the task.

schema_versionstringoptionalOptional schema version to use for tool execution

statusstringoptionalStatus of the task. Use 'needsAction' for an open task or 'completed' for a finished task.

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_task_list#Create a new task list in Google Tasks for the authenticated user. Returns the created task list with its ID and metadata. Uses DWD service account credentials.3 params▾

Create a new task list in Google Tasks for the authenticated user. Returns the created task list with its ID and metadata. Uses DWD service account credentials.

NameTypeRequiredDescription

titlestringrequiredTitle of the new task list.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_create_vault_matter#Create a new matter in Google Vault for e-discovery and legal hold purposes. Provide a name and an optional description. Uses DWD service account credentials.4 params▾

Create a new matter in Google Vault for e-discovery and legal hold purposes. Provide a name and an optional description. Uses DWD service account credentials.

NameTypeRequiredDescription

namestringrequiredName of the new Vault matter (e.g., 'Q1 Litigation 2024').

descriptionstringoptionalOptional description of the Vault matter.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_delete_contact#Permanently delete a contact from Google People using its resource name (e.g., 'people/c12345'). This action cannot be undone. Uses DWD service account credentials.3 params▾

Permanently delete a contact from Google People using its resource name (e.g., 'people/c12345'). This action cannot be undone. Uses DWD service account credentials.

NameTypeRequiredDescription

resource_namestringrequiredResource name of the contact to delete (e.g., 'people/c12345'). Obtain from a create or list response.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_delete_event#Delete an event from a connected Google Calendar account. Requires the calendar ID and event ID. Uses DWD service account credentials.4 params▾

Delete an event from a connected Google Calendar account. Requires the calendar ID and event ID. Uses DWD service account credentials.

NameTypeRequiredDescription

event_idstringrequiredThe ID of the calendar event to delete

calendar_idstringoptionalThe ID of the calendar from which the event should be deleted

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_delete_file#Permanently delete a file or folder in Google Drive by its file ID. This action cannot be undone. Uses DWD service account credentials.4 params▾

Permanently delete a file or folder in Google Drive by its file ID. This action cannot be undone. Uses DWD service account credentials.

NameTypeRequiredDescription

file_idstringrequiredID of the file or folder to delete

schema_versionstringoptionalOptional schema version to use for tool execution

supports_all_drivesbooleanoptionalWhether the request supports files in shared drives

tool_versionstringoptionalOptional tool version to use for execution

googledwd_delete_task#Permanently delete a task from a Google Tasks task list. This action cannot be undone. Uses DWD service account credentials.4 params▾

Permanently delete a task from a Google Tasks task list. This action cannot be undone. Uses DWD service account credentials.

NameTypeRequiredDescription

task_idstringrequiredThe ID of the task to delete.

task_list_idstringrequiredThe ID of the task list containing the task.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_end_meet_conference#End the active conference in a Google Meet space, disconnecting all participants. Requires the resource name of the space (e.g., 'spaces/abc123'). Uses DWD service account credentials.3 params▾

End the active conference in a Google Meet space, disconnecting all participants. Requires the resource name of the space (e.g., 'spaces/abc123'). Uses DWD service account credentials.

NameTypeRequiredDescription

space_namestringrequiredResource name of the Meet space whose active conference to end (e.g., 'spaces/abc123').

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_fetch_mails#Fetch emails from a connected Gmail account using search filters. Uses DWD service account credentials.8 params▾

Fetch emails from a connected Gmail account using search filters. Uses DWD service account credentials.

NameTypeRequiredDescription

formatstringoptionalFormat of the returned message.

include_spam_trashbooleanoptionalWhether to fetch emails from spam and trash folders

label_idsarrayoptionalGmail label IDs to filter messages

max_resultsintegeroptionalMaximum number of emails to fetch

page_tokenstringoptionalPage token for pagination

querystringoptionalSearch query string using Gmail's search syntax (e.g., 'is:unread from:user@example.com')

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_admin_group#Retrieve details of a specific Google Workspace group by its email address or unique group ID using the Admin Directory API. Uses DWD service account credentials.3 params▾

Retrieve details of a specific Google Workspace group by its email address or unique group ID using the Admin Directory API. Uses DWD service account credentials.

NameTypeRequiredDescription

group_keystringrequiredGroup email address or unique group ID to retrieve (e.g., 'engineering@example.com' or a numeric ID).

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_admin_user#Retrieve details of a specific Google Workspace user by their primary email address or unique user ID using the Admin Directory API. Uses DWD service account credentials.3 params▾

Retrieve details of a specific Google Workspace user by their primary email address or unique user ID using the Admin Directory API. Uses DWD service account credentials.

NameTypeRequiredDescription

user_keystringrequiredPrimary email address or unique user ID of the user to retrieve (e.g., 'john@example.com' or '123456789').

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_alert#Get details of a specific security alert from Google Workspace Alert Center. Uses DWD service account credentials.3 params▾

Get details of a specific security alert from Google Workspace Alert Center. Uses DWD service account credentials.

NameTypeRequiredDescription

alert_idstringrequiredThe unique identifier of the alert to retrieve. Example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_alert_metadata#Get metadata for a specific alert including acknowledgement status and assignee. Uses DWD service account credentials.3 params▾

Get metadata for a specific alert including acknowledgement status and assignee. Uses DWD service account credentials.

NameTypeRequiredDescription

alert_idstringrequiredThe unique identifier of the alert whose metadata to retrieve. Example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_attachment_by_id#Retrieve a specific attachment from a Gmail message using the message ID and attachment ID. Uses DWD service account credentials.5 params▾

Retrieve a specific attachment from a Gmail message using the message ID and attachment ID. Uses DWD service account credentials.

NameTypeRequiredDescription

attachment_idstringrequiredUnique Gmail attachment ID

message_idstringrequiredUnique Gmail message ID that contains the attachment

file_namestringoptionalPreferred filename to use when saving/returning the attachment

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_chat_space#Retrieve details of a specific Google Chat space (room or direct message) by its resource name (e.g., 'spaces/AAAA'). Uses DWD service account credentials.3 params▾

Retrieve details of a specific Google Chat space (room or direct message) by its resource name (e.g., 'spaces/AAAA'). Uses DWD service account credentials.

NameTypeRequiredDescription

space_namestringrequiredResource name of the Chat space to retrieve (e.g., 'spaces/AAAABBBBCCCC').

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_contacts#Fetch a list of contacts from the connected Gmail account. Supports pagination and field filtering. Uses DWD service account credentials.5 params▾

Fetch a list of contacts from the connected Gmail account. Supports pagination and field filtering. Uses DWD service account credentials.

NameTypeRequiredDescription

max_resultsintegeroptionalMaximum number of contacts to fetch

page_tokenstringoptionalToken to retrieve the next page of results

person_fieldsarrayoptionalFields to include for each person

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_event_by_id#Retrieve a specific calendar event by its ID using optional filtering and list parameters. Uses DWD service account credentials.11 params▾

Retrieve a specific calendar event by its ID using optional filtering and list parameters. Uses DWD service account credentials.

NameTypeRequiredDescription

event_idstringrequiredThe unique identifier of the calendar event to fetch

calendar_idstringoptionalThe calendar ID to search in

event_typesarrayoptionalFilter by Google event types

querystringoptionalFree text search query

schema_versionstringoptionalOptional schema version to use for tool execution

show_deletedbooleanoptionalInclude deleted events in results

single_eventsbooleanoptionalExpand recurring events into instances

time_maxstringoptionalUpper bound for event start time (RFC3339)

time_minstringoptionalLower bound for event start time (RFC3339)

tool_versionstringoptionalOptional tool version to use for execution

updated_minstringoptionalFilter events updated after this time (RFC3339)

googledwd_get_file_metadata#Retrieve metadata for a specific file in Google Drive by its file ID. Returns name, MIME type, size, creation time, and more.5 params▾

Retrieve metadata for a specific file in Google Drive by its file ID. Returns name, MIME type, size, creation time, and more.

NameTypeRequiredDescription

file_idstringrequiredThe ID of the file to retrieve metadata for

fieldsstringoptionalFields to include in the response

schema_versionstringoptionalOptional schema version to use for tool execution

supports_all_drivesbooleanoptionalSupport shared drives

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_form#Get the structure and metadata of a Google Form including its title, description, and all questions.1 param▾

Get the structure and metadata of a Google Form including its title, description, and all questions.

NameTypeRequiredDescription

form_idstringrequiredThe ID of the Google Form to retrieve

googledwd_get_group_settings#Get the settings for a Google Workspace group including posting permissions, membership settings, and moderation. Uses DWD service account credentials.3 params▾

Get the settings for a Google Workspace group including posting permissions, membership settings, and moderation. Uses DWD service account credentials.

NameTypeRequiredDescription

group_emailstringrequiredThe email address of the Google Workspace group whose settings to retrieve. Example: 'engineering@example.com'

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_keep_note#Retrieve a single Google Keep note by its resource name (e.g., 'notes/abc123'), including its title, body, and metadata. Uses DWD service account credentials.3 params▾

Retrieve a single Google Keep note by its resource name (e.g., 'notes/abc123'), including its title, body, and metadata. Uses DWD service account credentials.

NameTypeRequiredDescription

note_namestringrequiredResource name of the Keep note to retrieve (e.g., 'notes/abc123').

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_meet_space#Retrieve details of a Google Meet meeting space by its resource name (e.g., 'spaces/abc123'), including its meeting URI and configuration. Uses DWD service account credentials.3 params▾

Retrieve details of a Google Meet meeting space by its resource name (e.g., 'spaces/abc123'), including its meeting URI and configuration. Uses DWD service account credentials.

NameTypeRequiredDescription

space_namestringrequiredResource name of the Meet space to retrieve (e.g., 'spaces/abc123').

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_message_by_id#Retrieve a specific Gmail message using its message ID. Optionally control the format of the returned data. Uses DWD service account credentials.4 params▾

Retrieve a specific Gmail message using its message ID. Optionally control the format of the returned data. Uses DWD service account credentials.

NameTypeRequiredDescription

message_idstringrequiredUnique Gmail message ID

formatstringoptionalFormat of the returned message.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_response#Get a single response submitted to a Google Form by its response ID. Returns the respondent's answers for all questions.2 params▾

Get a single response submitted to a Google Form by its response ID. Returns the respondent's answers for all questions.

NameTypeRequiredDescription

form_idstringrequiredThe ID of the Google Form

response_idstringrequiredThe ID of the specific response to retrieve

googledwd_get_send_as#Get send-as alias settings including email signature for the authenticated Gmail account. Use the user's own email address to retrieve the default send-as settings and signature. Uses DWD service account credentials.3 params▾

Get send-as alias settings including email signature for the authenticated Gmail account. Use the user's own email address to retrieve the default send-as settings and signature. Uses DWD service account credentials.

NameTypeRequiredDescription

send_as_emailstringrequiredThe send-as alias email address to retrieve settings for. Use the user's own email address (e.g., 'user@example.com') to get their default signature and send-as settings.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_thread_by_id#Retrieve a specific Gmail thread by thread ID. Optionally control message format and metadata headers. Uses service account with Domain-Wide Delegation.5 params▾

Retrieve a specific Gmail thread by thread ID. Optionally control message format and metadata headers. Uses service account with Domain-Wide Delegation.

NameTypeRequiredDescription

thread_idstringrequiredUnique Gmail thread ID

formatstringoptionalFormat of messages in the returned thread.

metadata_headersarrayoptionalSpecific email headers to include when format is metadata

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_userinfo#Retrieve the profile information of the impersonated Google Workspace user, including their email address, name, and profile picture.2 params▾

Retrieve the profile information of the impersonated Google Workspace user, including their email address, name, and profile picture.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_vacation_settings#Get the vacation auto-reply settings for the authenticated Gmail account. Uses DWD service account credentials.2 params▾

Get the vacation auto-reply settings for the authenticated Gmail account. Uses DWD service account credentials.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_get_values#Returns only the cell values from a specific range in a Google Sheet — no metadata, no formatting, just the data. For full spreadsheet metadata and formatting, use googledwd_read_spreadsheet instead.6 params▾

Returns only the cell values from a specific range in a Google Sheet — no metadata, no formatting, just the data. For full spreadsheet metadata and formatting, use googledwd_read_spreadsheet instead.

NameTypeRequiredDescription

rangestringrequiredCell range to read in A1 notation

spreadsheet_idstringrequiredThe ID of the Google Sheet

major_dimensionstringoptionalWhether values are returned by rows or columns

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

value_render_optionstringoptionalHow values should be rendered in the response

googledwd_get_vault_matter#Retrieve details of a specific Google Vault matter by its matter ID. Optionally specify the view level (BASIC or FULL) to control how much detail is returned. Uses DWD service account credentials.4 params▾

Retrieve details of a specific Google Vault matter by its matter ID. Optionally specify the view level (BASIC or FULL) to control how much detail is returned. Uses DWD service account credentials.

NameTypeRequiredDescription

matter_idstringrequiredUnique ID of the Vault matter to retrieve (e.g., '0123456789abcdef').

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

viewstringoptionalLevel of detail to return. 'BASIC' returns metadata only; 'FULL' includes collaborators and other details.

googledwd_list_admin_activities#List audit log activity events for a specific user and application in Google Workspace using the Admin Reports API. Use 'all' for user_key to retrieve activities for all users. Uses DWD service account credentials.10 params▾

List audit log activity events for a specific user and application in Google Workspace using the Admin Reports API. Use 'all' for user_key to retrieve activities for all users. Uses DWD service account credentials.

NameTypeRequiredDescription

application_namestringrequiredName of the application whose activity records to retrieve. One of: 'admin', 'calendar', 'drive', 'gcp', 'groups', 'login', 'meet', 'mobile', 'rules', 'saml', 'token', 'user_accounts'.

user_keystringrequiredUser email address or unique user ID to retrieve activity for. Use 'all' to retrieve activities for all users.

end_timestringoptionalEnd of the time range for activity records in RFC3339 format (e.g., '2024-01-31T23:59:59Z').

event_namestringoptionalFilter by a specific event name within the application (e.g., 'LOGIN_SUCCESS' for the login application).

filtersstringoptionalComma-separated event parameter filters (e.g., 'IP_ADDRESS==1.2.3.4'). See Reports API docs for supported parameters.

max_resultsintegeroptionalMaximum number of activity records to return per page (1–1000).

page_tokenstringoptionalToken for the next page of results from a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

start_timestringoptionalStart of the time range for activity records in RFC3339 format (e.g., '2024-01-01T00:00:00Z').

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_admin_groups#List groups in a Google Workspace domain using the Admin Directory API. Supports filtering by domain, query string, and user membership. Uses DWD service account credentials.8 params▾

List groups in a Google Workspace domain using the Admin Directory API. Supports filtering by domain, query string, and user membership. Uses DWD service account credentials.

NameTypeRequiredDescription

customerstringoptionalCustomer ID or 'my_customer' for the authenticated account's domain (default: 'my_customer').

domainstringoptionalDomain name to filter groups (e.g., 'example.com').

max_resultsintegeroptionalMaximum number of groups to return per page (1–200).

page_tokenstringoptionalToken for the next page of results from a previous response.

querystringoptionalQuery string to filter groups (e.g., 'name:Engineering*').

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

user_keystringoptionalFilter groups to only those that contain this user (email or user ID).

googledwd_list_admin_users#List user accounts in a Google Workspace domain using the Admin Directory API. Supports filtering by domain, query string, ordering, and pagination. Uses DWD service account credentials.10 params▾

List user accounts in a Google Workspace domain using the Admin Directory API. Supports filtering by domain, query string, ordering, and pagination. Uses DWD service account credentials.

NameTypeRequiredDescription

customerstringoptionalCustomer ID or 'my_customer' for the authenticated account's domain (default: 'my_customer').

domainstringoptionalDomain name to filter users (e.g., 'example.com'). Mutually exclusive with customer.

max_resultsintegeroptionalMaximum number of users to return per page (1–500).

order_bystringoptionalField to sort users by. One of: 'email', 'familyName', 'givenName'.

page_tokenstringoptionalToken for the next page of results from a previous response.

querystringoptionalQuery string to filter users (e.g., 'email:admin*', 'name:John').

schema_versionstringoptionalOptional schema version to use for tool execution

show_deletedstringoptionalIf 'true', retrieves deleted users. Default is 'false'.

sort_orderstringoptionalSort direction for results. One of: 'ASCENDING', 'DESCENDING'.

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_alert_feedback#List all feedback entries for a specific security alert. Uses DWD service account credentials.3 params▾

List all feedback entries for a specific security alert. Uses DWD service account credentials.

NameTypeRequiredDescription

alert_idstringrequiredThe unique identifier of the alert whose feedback to list. Example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_alerts#List security alerts from Google Workspace Alert Center. Shows suspicious logins, DLP violations, and other security events. Uses DWD service account credentials.6 params▾

List security alerts from Google Workspace Alert Center. Shows suspicious logins, DLP violations, and other security events. Uses DWD service account credentials.

NameTypeRequiredDescription

filterstringoptionalFilter string to narrow alert results. Example: "type=\"Suspicious login\""

order_bystringoptionalSort order for results. Example: 'createTime desc'

page_sizeintegeroptionalMaximum number of alerts to return per page. Max 100.

page_tokenstringoptionalToken for the next page of results from a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_calendars#List all accessible Google Calendar calendars for the authenticated user. Supports filters and pagination. Uses DWD service account credentials.8 params▾

List all accessible Google Calendar calendars for the authenticated user. Supports filters and pagination. Uses DWD service account credentials.

NameTypeRequiredDescription

max_resultsintegeroptionalMaximum number of calendars to fetch

min_access_rolestringoptionalMinimum access role to include in results

page_tokenstringoptionalToken to retrieve the next page of results

schema_versionstringoptionalOptional schema version to use for tool execution

show_deletedbooleanoptionalInclude deleted calendars in the list

show_hiddenbooleanoptionalInclude calendars that are hidden from the calendar list

sync_tokenstringoptionalToken to get updates since the last sync

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_chat_members#List members (human users and bots) in a Google Chat space. Supports filtering and pagination, with optional inclusion of Google Groups and invited members. Uses DWD service account credentials.8 params▾

List members (human users and bots) in a Google Chat space. Supports filtering and pagination, with optional inclusion of Google Groups and invited members. Uses DWD service account credentials.

NameTypeRequiredDescription

space_namestringrequiredResource name of the Chat space to list members for (e.g., 'spaces/AAAABBBBCCCC').

filterstringoptionalQuery filter for members. Example: 'member.type = "HUMAN"'.

page_sizeintegeroptionalMaximum number of members to return per page (1–1000).

page_tokenstringoptionalToken for the next page of results from a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

show_groupsbooleanoptionalIf true, include Google Groups in the member list.

show_invitedbooleanoptionalIf true, include invited (pending) members in the results.

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_chat_messages#List messages in a Google Chat space. Supports filtering, ordering, and pagination. Optionally include deleted messages. Uses DWD service account credentials.8 params▾

List messages in a Google Chat space. Supports filtering, ordering, and pagination. Optionally include deleted messages. Uses DWD service account credentials.

NameTypeRequiredDescription

space_namestringrequiredResource name of the Chat space to list messages from (e.g., 'spaces/AAAABBBBCCCC').

filterstringoptionalQuery filter for messages. Example: 'createTime > "2024-01-01T00:00:00Z"'.

order_bystringoptionalSort field and direction for results (e.g., 'createTime asc' or 'createTime desc').

page_sizeintegeroptionalMaximum number of messages to return per page (1–1000).

page_tokenstringoptionalToken for the next page of results from a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

show_deletedbooleanoptionalIf true, include deleted messages in the results.

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_chat_spaces#List Google Chat spaces (rooms and direct messages) that the authenticated user or service account has access to. Supports filtering and pagination. Uses DWD service account credentials.5 params▾

List Google Chat spaces (rooms and direct messages) that the authenticated user or service account has access to. Supports filtering and pagination. Uses DWD service account credentials.

NameTypeRequiredDescription

filterstringoptionalQuery filter for spaces. Example: 'spaceType = "SPACE"' or 'spaceType = "GROUP_CHAT"'.

page_sizeintegeroptionalMaximum number of spaces to return per page (1–1000).

page_tokenstringoptionalToken for the next page of results from a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_documents#List all Google Docs documents in the impersonated user's Drive. Optionally search by document name. Returns document IDs, names, and metadata with pagination support.4 params▾

List all Google Docs documents in the impersonated user's Drive. Optionally search by document name. Returns document IDs, names, and metadata with pagination support.

NameTypeRequiredDescription

order_bystringoptionalSort order for results. Examples: modifiedTime desc, name asc, createdTime desc

page_sizeintegeroptionalNumber of documents to return per page (max 1000, default 100)

page_tokenstringoptionalToken for retrieving the next page of results. Use the nextPageToken from a previous response.

querystringoptionalDrive search query to filter documents. Defaults to all Google Docs. To search by name, use: mimeType = 'application/vnd.google-apps.document' and trashed = false and name contains 'report'

googledwd_list_drafts#List draft emails from a connected Gmail account. Uses DWD service account credentials.4 params▾

List draft emails from a connected Gmail account. Uses DWD service account credentials.

NameTypeRequiredDescription

max_resultsintegeroptionalMaximum number of drafts to fetch

page_tokenstringoptionalPage token for pagination

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_events#List events from a connected Google Calendar account with filtering options. Uses DWD service account credentials.10 params▾

List events from a connected Google Calendar account with filtering options. Uses DWD service account credentials.

NameTypeRequiredDescription

calendar_idstringoptionalCalendar ID to list events from

max_resultsintegeroptionalMaximum number of events to fetch

order_bystringoptionalOrder of events in the result

page_tokenstringoptionalPage token for pagination

querystringoptionalFree text search query

schema_versionstringoptionalOptional schema version to use for tool execution

single_eventsbooleanoptionalExpand recurring events into single events

time_maxstringoptionalUpper bound for event start time (RFC3339 timestamp)

time_minstringoptionalLower bound for event start time (RFC3339 timestamp)

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_filters#List all email filters for the authenticated Gmail account. Returns filter criteria and actions such as label assignment, forwarding, and archiving rules. Uses DWD service account credentials.2 params▾

List all email filters for the authenticated Gmail account. Returns filter criteria and actions such as label assignment, forwarding, and archiving rules. Uses DWD service account credentials.

NameTypeRequiredDescription

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_group_members#List the members of a Google Workspace group using the Admin Directory API. Supports filtering by role and pagination. Uses DWD service account credentials.7 params▾

List the members of a Google Workspace group using the Admin Directory API. Supports filtering by role and pagination. Uses DWD service account credentials.

NameTypeRequiredDescription

group_keystringrequiredGroup email address or unique group ID whose members to list (e.g., 'engineering@example.com').

include_derived_membershipbooleanoptionalIf true, include members inherited from sub-groups or nested groups.

max_resultsintegeroptionalMaximum number of members to return per page (1–200).

page_tokenstringoptionalToken for the next page of results from a previous response.

rolesstringoptionalFilter members by role. Comma-separated values from: 'OWNER', 'MANAGER', 'MEMBER'.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_keep_notes#List notes in Google Keep. Supports filtering (e.g., by trashed status) and pagination. Returns up to 100 notes per page. Uses DWD service account credentials.5 params▾

List notes in Google Keep. Supports filtering (e.g., by trashed status) and pagination. Returns up to 100 notes per page. Uses DWD service account credentials.

NameTypeRequiredDescription

filterstringoptionalFilter expression for notes. Example: 'trashed = false' or 'trashed = true'.

page_sizeintegeroptionalMaximum number of notes to return per page (1–100).

page_tokenstringoptionalToken for the next page of results from a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_org_units#List organizational units (OUs) in a Google Workspace customer account using the Admin Directory API. Supports filtering by parent OU path and retrieval type. Uses DWD service account credentials.5 params▾

List organizational units (OUs) in a Google Workspace customer account using the Admin Directory API. Supports filtering by parent OU path and retrieval type. Uses DWD service account credentials.

NameTypeRequiredDescription

customer_idstringoptionalCustomer ID or 'my_customer' for the authenticated account's domain (default: 'my_customer').

org_unit_pathstringoptionalFull path of the parent organizational unit to list children of (e.g., '/Engineering').

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

typestringoptionalType of OUs to return. 'all' returns all OUs; 'children' returns only direct children of the specified org_unit_path.

googledwd_list_responses#List all responses submitted to a Google Form. Returns response IDs, submission timestamps, and answer values for each respondent.4 params▾

List all responses submitted to a Google Form. Returns response IDs, submission timestamps, and answer values for each respondent.

NameTypeRequiredDescription

form_idstringrequiredThe ID of the Google Form to list responses for

filterstringoptionalFilter responses by submission time. Format: timestamp > 2026-01-01T00:00:00Z

page_sizeintegeroptionalMaximum number of responses to return (max 5000)

page_tokenstringoptionalToken for retrieving the next page of results

googledwd_list_task_lists#List all task lists for the authenticated user in Google Tasks. Returns a paginated collection of task lists. Uses DWD service account credentials.4 params▾

List all task lists for the authenticated user in Google Tasks. Returns a paginated collection of task lists. Uses DWD service account credentials.

NameTypeRequiredDescription

max_resultsintegeroptionalMaximum number of task lists to return. Accepted value is between 1 and 100.

page_tokenstringoptionalToken specifying the page of results to return. Obtained from nextPageToken in a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_tasks#List all tasks in a specified Google Tasks task list. Supports filtering by completion status, deletion status, and due date range. Uses DWD service account credentials.10 params▾

List all tasks in a specified Google Tasks task list. Supports filtering by completion status, deletion status, and due date range. Uses DWD service account credentials.

NameTypeRequiredDescription

task_list_idstringrequiredThe ID of the task list to retrieve tasks from.

due_maxstringoptionalUpper bound for a task's due date (RFC3339 datetime). Tasks due after this datetime are excluded.

due_minstringoptionalLower bound for a task's due date (RFC3339 datetime). Tasks due before this datetime are excluded.

max_resultsintegeroptionalMaximum number of tasks to return. Accepted value is between 1 and 100.

page_tokenstringoptionalToken specifying the page of results to return. Obtained from nextPageToken in a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

show_completedbooleanoptionalFlag indicating whether completed tasks are returned. The default is true.

show_deletedbooleanoptionalFlag indicating whether deleted tasks are returned. The default is false.

show_hiddenbooleanoptionalFlag indicating whether hidden tasks are returned. The default is false.

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_threads#List threads in a Gmail account using optional search and label filters. Uses service account with Domain-Wide Delegation.7 params▾

List threads in a Gmail account using optional search and label filters. Uses service account with Domain-Wide Delegation.

NameTypeRequiredDescription

include_spam_trashbooleanoptionalWhether to include threads from Spam and Trash

label_idsarrayoptionalGmail label IDs to filter threads (threads must match all labels)

max_resultsintegeroptionalMaximum number of threads to return

page_tokenstringoptionalPage token for pagination

querystringoptionalSearch query string using Gmail search syntax (for example, 'is:unread from:user@example.com')

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_list_vault_matters#List matters in Google Vault. Supports filtering by state (OPEN, CLOSED, DELETED) and specifying the view level (BASIC or FULL). Uses DWD service account credentials.6 params▾

List matters in Google Vault. Supports filtering by state (OPEN, CLOSED, DELETED) and specifying the view level (BASIC or FULL). Uses DWD service account credentials.

NameTypeRequiredDescription

page_sizeintegeroptionalMaximum number of matters to return per page (1–100).

page_tokenstringoptionalToken for the next page of results from a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

statestringoptionalFilter matters by state. One of: 'OPEN', 'CLOSED', 'DELETED'.

tool_versionstringoptionalOptional tool version to use for execution

viewstringoptionalLevel of detail to return. 'BASIC' returns metadata only; 'FULL' includes collaborators and other details.

googledwd_modify_message_labels#Add or remove labels on a Gmail message. Use label IDs such as 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT', 'TRASH', 'SPAM', or custom label IDs. At least one of add_label_ids or remove_label_ids should be provided. Uses DWD service account credentials.5 params▾

Add or remove labels on a Gmail message. Use label IDs such as 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT', 'TRASH', 'SPAM', or custom label IDs. At least one of add_label_ids or remove_label_ids should be provided. Uses DWD service account credentials.

NameTypeRequiredDescription

message_idstringrequiredThe Gmail message ID whose labels will be modified. Obtain this from a list or search messages operation. Example: '17a1b2c3d4e5f6g7'.

add_label_idsarrayoptionalList of label IDs to add to the message. Use system labels such as 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT', or custom label IDs retrieved from the Labels API. Example: ["STARRED", "INBOX"].

remove_label_idsarrayoptionalList of label IDs to remove from the message. Use system labels such as 'UNREAD', 'STARRED', 'INBOX', or custom label IDs. Example: ["UNREAD"].

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_move_file#Move a file or folder to a different location in Google Drive by updating its parent folder. Optionally rename the file during the move. Uses DWD service account credentials.6 params▾

Move a file or folder to a different location in Google Drive by updating its parent folder. Optionally rename the file during the move. Uses DWD service account credentials.

NameTypeRequiredDescription

file_idstringrequiredID of the file or folder to move

new_parent_idstringrequiredID of the destination folder to move the file into

namestringoptionalOptional new name for the file after moving. If omitted, the file keeps its current name.

old_parent_idstringoptionalID of the current parent folder to remove the file from. Providing this ensures a clean move without the file appearing in multiple folders.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_query_drive_activity#Query Google Drive activity to see who viewed, edited, moved, or shared files. Useful for auditing and compliance. Uses DWD service account credentials.8 params▾

Query Google Drive activity to see who viewed, edited, moved, or shared files. Useful for auditing and compliance. Uses DWD service account credentials.

NameTypeRequiredDescription

ancestor_namestringoptionalRestrict activity to items under this folder. Format: 'items/FOLDER_ID'. Example: 'items/0B_abc123xyz'

consolidation_strategystringoptionalHow related activity is grouped. 'none' means each action is its own activity; 'legacy' consolidates similar actions. Valid values: 'none', 'legacy'.

filterstringoptionalFilter string to narrow activity results. Example: "time >= \"2026-01-01T00:00:00Z\""

item_namestringoptionalRestrict activity to a specific file or folder. Format: 'items/FILE_ID'. Example: 'items/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms'

page_sizeintegeroptionalMaximum number of activity records to return per page. Max 100.

page_tokenstringoptionalToken for the next page of results from a previous response.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_read_document#Read the complete content and structure of a Google Doc including text, formatting, tables, and metadata.4 params▾

Read the complete content and structure of a Google Doc including text, formatting, tables, and metadata.

NameTypeRequiredDescription

document_idstringrequiredThe ID of the Google Doc to read

schema_versionstringoptionalOptional schema version to use for tool execution

suggestions_view_modestringoptionalHow suggestions are rendered in the response

tool_versionstringoptionalOptional tool version to use for execution

googledwd_read_presentation#Read the complete structure and content of a Google Slides presentation including slides, text, images, shapes, and metadata.4 params▾

Read the complete structure and content of a Google Slides presentation including slides, text, images, shapes, and metadata.

NameTypeRequiredDescription

presentation_idstringrequiredThe ID of the Google Slides presentation to read

fieldsstringoptionalFields to include in the response

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_read_spreadsheet#Returns everything about a spreadsheet — including spreadsheet metadata, sheet properties, cell values, formatting, themes, and pixel sizes. If you only need cell values, use googledwd_get_values instead.5 params▾

Returns everything about a spreadsheet — including spreadsheet metadata, sheet properties, cell values, formatting, themes, and pixel sizes. If you only need cell values, use googledwd_get_values instead.

NameTypeRequiredDescription

spreadsheet_idstringrequiredThe ID of the Google Sheet to read

include_grid_databooleanoptionalInclude cell data in the response

rangesstringoptionalCell range to read in A1 notation

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_search_content#Search inside the content of files stored in Google Drive using full-text search. Finds files where the body text matches the search term.8 params▾

Search inside the content of files stored in Google Drive using full-text search. Finds files where the body text matches the search term.

NameTypeRequiredDescription

search_termstringrequiredText to search for inside file contents

fieldsstringoptionalFields to include in the response

mime_typestringoptionalFilter results by MIME type

page_sizeintegeroptionalNumber of files to return per page

page_tokenstringoptionalToken for the next page of results

schema_versionstringoptionalOptional schema version to use for tool execution

supports_all_drivesbooleanoptionalInclude shared drives in results

tool_versionstringoptionalOptional tool version to use for execution

googledwd_search_files#Search for files and folders in Google Drive using query filters like name, type, owner, and parent folder.8 params▾

Search for files and folders in Google Drive using query filters like name, type, owner, and parent folder.

NameTypeRequiredDescription

fieldsstringoptionalFields to include in the response

order_bystringoptionalSort order for results

page_sizeintegeroptionalNumber of files to return per page

page_tokenstringoptionalToken for the next page of results

querystringoptionalDrive search query string

schema_versionstringoptionalOptional schema version to use for tool execution

supports_all_drivesbooleanoptionalInclude shared drives in results

tool_versionstringoptionalOptional tool version to use for execution

googledwd_search_people#Search people or contacts in the connected Google account using a query. Uses DWD service account credentials.6 params▾

Search people or contacts in the connected Google account using a query. Uses DWD service account credentials.

NameTypeRequiredDescription

querystringrequiredText query to search people (e.g., name, email address).

other_contactsbooleanoptionalWhether to include people not in the user's contacts (from 'Other Contacts').

page_sizeintegeroptionalMaximum number of people to return.

person_fieldsarrayoptionalFields to retrieve for each person.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_share_file#Share a file or folder in Google Drive by creating a new permission for a user, group, domain, or anyone. Supports sending notification emails. Uses DWD service account credentials.10 params▾

Share a file or folder in Google Drive by creating a new permission for a user, group, domain, or anyone. Supports sending notification emails. Uses DWD service account credentials.

NameTypeRequiredDescription

file_idstringrequiredID of the file or folder to share

rolestringrequiredThe role to grant to the recipient. One of: 'reader', 'commenter', 'writer', 'organizer', 'fileOrganizer', 'owner'.

typestringrequiredThe type of principal to share with. One of: 'user', 'group', 'domain', 'anyone'.

domainstringoptionalThe domain to share with. Required when type is 'domain'. Example: 'example.com'.

email_addressstringoptionalEmail address of the user or group to share with. Required when type is 'user' or 'group'. Example: 'user@example.com'.

email_messagestringoptionalCustom message to include in the notification email sent to the recipient.

schema_versionstringoptionalOptional schema version to use for tool execution

send_notification_emailbooleanoptionalWhether to send a notification email to the recipient. Defaults to true.

tool_versionstringoptionalOptional tool version to use for execution

transfer_ownershipbooleanoptionalWhether to transfer ownership of the file to the recipient. Only valid when role is 'owner'.

googledwd_trash_message#Move a Gmail message to the Trash. The message is not permanently deleted and can be recovered from Trash within 30 days. This operation is idempotent — trashing an already-trashed message is a no-op. Uses DWD service account credentials.3 params▾

Move a Gmail message to the Trash. The message is not permanently deleted and can be recovered from Trash within 30 days. This operation is idempotent — trashing an already-trashed message is a no-op. Uses DWD service account credentials.

NameTypeRequiredDescription

message_idstringrequiredThe Gmail message ID to move to Trash. Obtain this from a list or search messages operation. Example: '17a1b2c3d4e5f6g7'.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_update_contact#Update an existing Google People contact's names, email address, or phone number. Requires the contact's resource name (e.g., 'people/c12345') and the current etag to prevent conflicts. Uses DWD service account credentials.8 params▾

Update an existing Google People contact's names, email address, or phone number. Requires the contact's resource name (e.g., 'people/c12345') and the current etag to prevent conflicts. Uses DWD service account credentials.

NameTypeRequiredDescription

etagstringrequiredCurrent etag of the contact, required to prevent update conflicts. Obtain from a previous get or list response.

resource_namestringrequiredResource name of the contact to update (e.g., 'people/c12345'). Obtain from a create or list response.

emailstringoptionalUpdated email address for the contact (e.g., newemail@example.com).

family_namestringoptionalUpdated family (last) name of the contact.

given_namestringoptionalUpdated given (first) name of the contact.

phone_numberstringoptionalUpdated phone number for the contact (e.g., +1-555-555-5555).

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

googledwd_update_document#Update the content of an existing Google Doc using batch update requests. Supports inserting and deleting text, formatting, tables, and other document elements.5 params▾

Update the content of an existing Google Doc using batch update requests. Supports inserting and deleting text, formatting, tables, and other document elements.

NameTypeRequiredDescription

document_idstringrequiredThe ID of the Google Doc to update

requestsarrayrequiredArray of update requests to apply to the document

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

write_controlobjectoptionalOptional write control for revision management

googledwd_update_event#Update an existing event in a Google Calendar account. Only provided fields will be updated. Supports updating time, attendees, location, meeting links, and more. Uses DWD service account credentials.22 params▾

Update an existing event in a Google Calendar account. Only provided fields will be updated. Supports updating time, attendees, location, meeting links, and more. Uses DWD service account credentials.

NameTypeRequiredDescription

calendar_idstringrequiredCalendar ID containing the event

event_idstringrequiredThe ID of the calendar event to update

attendees_emailsarrayoptionalAttendee email addresses

create_meeting_roombooleanoptionalGenerate a Google Meet link for this event

descriptionstringoptionalOptional event description

end_datetimestringoptionalEvent end time in RFC3339 format

event_duration_hourintegeroptionalDuration of event in hours

event_duration_minutesintegeroptionalDuration of event in minutes

event_typestringoptionalEvent type for display purposes

guests_can_invite_othersbooleanoptionalAllow guests to invite others

guests_can_modifybooleanoptionalAllow guests to modify the event

guests_can_see_other_guestsbooleanoptionalAllow guests to see each other

locationstringoptionalLocation of the event

recurrencearrayoptionalRecurrence rules (iCalendar RRULE format)

schema_versionstringoptionalOptional schema version to use for tool execution

send_updatesbooleanoptionalSend update notifications to attendees

start_datetimestringoptionalEvent start time in RFC3339 format

summarystringoptionalEvent title/summary

timezonestringoptionalTimezone for the event (IANA time zone identifier)

tool_versionstringoptionalOptional tool version to use for execution

transparencystringoptionalCalendar transparency (free/busy)

visibilitystringoptionalVisibility of the event

googledwd_update_group_settings#Update settings for a Google Workspace group. Control who can post, join, view members, and more. Uses DWD service account credentials.10 params▾

Update settings for a Google Workspace group. Control who can post, join, view members, and more. Uses DWD service account credentials.

NameTypeRequiredDescription

group_emailstringrequiredThe email address of the Google Workspace group to update. Example: 'engineering@example.com'

allow_external_membersbooleanoptionalWhether members outside the domain can join the group. True to allow external members, false to restrict to domain only.

is_archivedbooleanoptionalWhether the group is archived. Archived groups cannot receive new messages.

message_moderation_levelstringoptionalModeration level for messages posted to the group. Valid values: 'MODERATE_ALL_MESSAGES', 'MODERATE_NON_MEMBERS', 'MODERATE_NEW_MEMBERS', 'MODERATE_NONE'.

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

who_can_joinstringoptionalPermission to join the group. Valid values: 'ANYONE_CAN_JOIN', 'ALL_IN_DOMAIN_CAN_JOIN', 'INVITED_CAN_JOIN', 'CAN_REQUEST_TO_JOIN'.

who_can_post_messagestringoptionalPermission to post messages to the group. Valid values: 'NONE_CAN_POST', 'ALL_MANAGERS_CAN_POST', 'ALL_MEMBERS_CAN_POST', 'ALL_OWNERS_CAN_POST', 'ALL_IN_DOMAIN_CAN_POST', 'ANYONE_CAN_POST'.

who_can_view_groupstringoptionalPermission to view the group's messages. Valid values: 'ANYONE_CAN_VIEW', 'ALL_IN_DOMAIN_CAN_VIEW', 'ALL_MEMBERS_CAN_VIEW', 'ALL_MANAGERS_CAN_VIEW', 'ALL_OWNERS_CAN_VIEW'.

who_can_view_membershipstringoptionalPermission to view the group's member list. Valid values: 'ALL_IN_DOMAIN_CAN_VIEW', 'ALL_MEMBERS_CAN_VIEW', 'ALL_MANAGERS_CAN_VIEW', 'ALL_OWNERS_CAN_VIEW'.

googledwd_update_send_as#Update send-as alias settings such as the email signature, display name, or reply-to address for the authenticated Gmail account. Use the user's own email address to update their default signature. Uses DWD service account credentials.7 params▾

Update send-as alias settings such as the email signature, display name, or reply-to address for the authenticated Gmail account. Use the user's own email address to update their default signature. Uses DWD service account credentials.

NameTypeRequiredDescription

send_as_emailstringrequiredThe send-as alias email address to update. Use the user's own email address (e.g., 'user@example.com') to update their default signature and settings.

display_namestringoptionalThe display name shown as the sender name for this alias (e.g., 'Jane Smith').

is_defaultbooleanoptionalIf true, sets this send-as alias as the default address used when composing new messages.

reply_to_addressstringoptionalAn optional email address that appears in the Reply-To header for messages sent from this alias (e.g., 'replies@example.com').

schema_versionstringoptionalOptional schema version to use for tool execution

signaturestringoptionalHTML email signature to set for this alias. Supports full HTML markup (e.g., '<b>Jane Smith</b><br>Senior Engineer').

tool_versionstringoptionalOptional tool version to use for execution

googledwd_update_task#Update an existing task in a Google Tasks task list. Only the fields you provide will be updated. Supports changing title, notes, due date, and status. Uses DWD service account credentials.8 params▾

Update an existing task in a Google Tasks task list. Only the fields you provide will be updated. Supports changing title, notes, due date, and status. Uses DWD service account credentials.

NameTypeRequiredDescription

task_idstringrequiredThe ID of the task to update.

task_list_idstringrequiredThe ID of the task list containing the task.

duestringoptionalUpdated due date and time of the task in RFC3339 datetime format (e.g., 2025-08-15T17:00:00Z). Note: the time portion is ignored by the Google Tasks API; only the date is used.

notesstringoptionalUpdated notes or description for the task.

schema_versionstringoptionalOptional schema version to use for tool execution

statusstringoptionalUpdated status of the task. Use 'needsAction' to reopen a task or 'completed' to mark it done.

titlestringoptionalUpdated title of the task.

tool_versionstringoptionalOptional tool version to use for execution

googledwd_update_vacation_settings#Update the vacation auto-reply settings for the authenticated Gmail account. Set enableAutoReply to true to activate out-of-office responses. Uses DWD service account credentials.10 params▾

Update the vacation auto-reply settings for the authenticated Gmail account. Set enableAutoReply to true to activate out-of-office responses. Uses DWD service account credentials.

NameTypeRequiredDescription

enable_auto_replybooleanrequiredWhether to enable the vacation auto-reply. Set to true to turn on out-of-office responses, false to disable.

end_timestringoptionalEnd time for the vacation auto-reply as epoch milliseconds in string format (e.g., '1754006400000'). After this time, auto-reply stops.

response_body_htmlstringoptionalHTML body of the vacation auto-reply message. If both plain text and HTML are provided, HTML takes precedence for clients that support it.

response_body_plain_textstringoptionalPlain text body of the vacation auto-reply message.

response_subjectstringoptionalSubject line of the vacation auto-reply email (e.g., 'Out of Office: Back on Monday').

restrict_to_contactsbooleanoptionalIf true, only contacts in the user's Google Contacts will receive the auto-reply. Default is false.

restrict_to_domainbooleanoptionalIf true, only users in the same Google Workspace domain will receive the auto-reply. Default is false.

schema_versionstringoptionalOptional schema version to use for tool execution

start_timestringoptionalStart time for the vacation auto-reply as epoch milliseconds in string format (e.g., '1753401600000'). Auto-reply activates from this time.

tool_versionstringoptionalOptional tool version to use for execution

googledwd_update_values#Update cell values in a specific range of a Google Sheet. Supports writing single cells or multiple rows and columns at once.7 params▾

Update cell values in a specific range of a Google Sheet. Supports writing single cells or multiple rows and columns at once.

NameTypeRequiredDescription

rangestringrequiredCell range to update in A1 notation

spreadsheet_idstringrequiredThe ID of the Google Sheet to update

valuesarrayrequired2D array of values to write to the range

include_values_in_responsebooleanoptionalReturn the updated cell values in the response

schema_versionstringoptionalOptional schema version to use for tool execution

tool_versionstringoptionalOptional tool version to use for execution

value_input_optionstringoptionalHow input values should be interpreted