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 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.

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)

Common workflows

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.

Name Type Required Description

range string required The A1 notation range to append data to (e.g. Sheet1!A1)

spreadsheet_id string required The ID of the spreadsheet to append data to

values array required 2D array of values to append. Each inner array is a row.

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

value_input_option string optional How 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.

Name Type Required Description

range string required The A1 notation range to clear (e.g. Sheet1!A1:D10)

spreadsheet_id string required The 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.

Name Type Required Description

task_id string required The ID of the task to mark as completed.

task_list_id string required The ID of the task list containing the task.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

file_id string required ID of the file to copy

description string optional Optional description for the copied file

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

parent_folder_id string optional ID of the destination folder for the copy. If omitted, the copy is placed in the same folder as the original.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

space_name string required Resource name of the Chat space to post the message to (e.g., 'spaces/AAAABBBBCCCC').

text string required Plain text body of the message to send.

request_id string optional Unique 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_version string optional Optional schema version to use for tool execution

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

tool_version string optional Optional 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.

Name Type Required Description

given_name string required Given (first) name of the contact. Required.

email string optional Email address for the new contact (e.g., jane@example.com).

family_name string optional Family (last) name of the contact.

job_title string optional Job title of the contact within their organization.

notes string optional Free-text notes or biography to associate with the contact.

organization string optional Organization (company) name for the contact.

phone_number string optional Phone number for the contact (e.g., +1-555-555-5555).

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

schema_version string optional Optional schema version to use for tool execution

title string optional Title of the new document

tool_version string optional Optional 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.

Name Type Required Description

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

subject string required The subject line of the draft email. Example: 'Meeting Follow-up'.

to string required The 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'.

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

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

content_type string optional The MIME content type for the email body. Use 'text/plain' for plain text or 'text/html' for HTML content. Defaults to 'text/plain'.

schema_version string optional Optional schema version to use for tool execution

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

tool_version string optional Optional 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.

Name Type Required Description

start_datetime string required Event start time in RFC3339 format

summary string required Event title/summary

attendees_emails array optional Attendee email addresses

calendar_id string optional Calendar ID to create the event in

create_meeting_room boolean optional Generate a Google Meet link for this event

description string optional Optional event description

event_duration_hour integer optional Duration of event in hours

event_duration_minutes integer optional Duration of event in minutes

event_type string optional Event type for display purposes

guests_can_invite_others boolean optional Allow guests to invite others

guests_can_modify boolean optional Allow guests to modify the event

guests_can_see_other_guests boolean optional Allow guests to see each other

location string optional Location of the event

recurrence array optional Recurrence rules (iCalendar RRULE format)

schema_version string optional Optional schema version to use for tool execution

send_updates boolean optional Send update notifications to attendees

timezone string optional Timezone for the event (IANA time zone identifier)

tool_version string optional Optional tool version to use for execution

transparency string optional Calendar transparency (free/busy)

visibility string optional Visibility 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.

Name Type Required Description

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

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

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

has_attachment boolean optional If true, only match messages that have at least one attachment.

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

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

schema_version string optional Optional schema version to use for tool execution

should_always_mark_important boolean optional If true, always mark matching messages as important regardless of Gmail's automatic importance detection.

should_archive boolean optional If true, skip the inbox for matching messages (equivalent to adding the 'Archive' action).

should_mark_read boolean optional If true, automatically mark matching messages as read.

should_never_mark_important boolean optional If true, never mark matching messages as important, overriding Gmail's automatic importance detection.

should_never_spam boolean optional If true, never send matching messages to the Spam folder.

should_star boolean optional If true, automatically star matching messages.

should_trash boolean optional If true, automatically move matching messages to the Trash.

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

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

tool_version string optional Optional 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.

Name Type Required Description

name string required Name of the new folder

description string optional Optional description for the new folder

parent_folder_id string optional ID of the parent folder to create this folder inside. If omitted, the folder is created in the root of My Drive.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

title string required The title of the form shown to respondents

document_title string optional The 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.

Name Type Required Description

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

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

schema_version string optional Optional schema version to use for tool execution

title string optional Title of the new presentation

tool_version string optional Optional 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.

Name Type Required Description

locale string optional Locale of the spreadsheet

schema_version string optional Optional schema version to use for tool execution

sheets array optional Initial sheets to include in the spreadsheet

time_zone string optional Time zone for the spreadsheet

title string optional Title of the new spreadsheet

tool_version string optional Optional 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.

Name Type Required Description

task_list_id string required The ID of the task list in which to create the task.

title string required Title of the new task.

due string optional 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.

notes string optional Additional notes or description for the task.

schema_version string optional Optional schema version to use for tool execution

status string optional Status of the task. Use 'needsAction' for an open task or 'completed' for a finished task.

tool_version string optional Optional 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.

Name Type Required Description

title string required Title of the new task list.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

name string required Name of the new Vault matter (e.g., 'Q1 Litigation 2024').

description string optional Optional description of the Vault matter.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

event_id string required The ID of the calendar event to delete

calendar_id string optional The ID of the calendar from which the event should be deleted

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

file_id string required ID of the file or folder to delete

schema_version string optional Optional schema version to use for tool execution

supports_all_drives boolean optional Whether the request supports files in shared drives

tool_version string optional Optional 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.

Name Type Required Description

task_id string required The ID of the task to delete.

task_list_id string required The ID of the task list containing the task.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

format string optional Format of the returned message.

include_spam_trash boolean optional Whether to fetch emails from spam and trash folders

label_ids array optional Gmail label IDs to filter messages

max_results integer optional Maximum number of emails to fetch

page_token string optional Page token for pagination

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

alert_id string required The unique identifier of the alert to retrieve. Example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

alert_id string required The unique identifier of the alert whose metadata to retrieve. Example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

attachment_id string required Unique Gmail attachment ID

message_id string required Unique Gmail message ID that contains the attachment

file_name string optional Preferred filename to use when saving/returning the attachment

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

space_name string required Resource name of the Chat space to retrieve (e.g., 'spaces/AAAABBBBCCCC').

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

max_results integer optional Maximum number of contacts to fetch

page_token string optional Token to retrieve the next page of results

person_fields array optional Fields to include for each person

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

event_id string required The unique identifier of the calendar event to fetch

calendar_id string optional The calendar ID to search in

event_types array optional Filter by Google event types

query string optional Free text search query

schema_version string optional Optional schema version to use for tool execution

show_deleted boolean optional Include deleted events in results

single_events boolean optional Expand recurring events into instances

time_max string optional Upper bound for event start time (RFC3339)

time_min string optional Lower bound for event start time (RFC3339)

tool_version string optional Optional tool version to use for execution

updated_min string optional Filter 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.

Name Type Required Description

file_id string required The ID of the file to retrieve metadata for

fields string optional Fields to include in the response

schema_version string optional Optional schema version to use for tool execution

supports_all_drives boolean optional Support shared drives

tool_version string optional Optional 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.

Name Type Required Description

form_id string required The 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.

Name Type Required Description

group_email string required The email address of the Google Workspace group whose settings to retrieve. Example: 'engineering@example.com'

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

note_name string required Resource name of the Keep note to retrieve (e.g., 'notes/abc123').

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

space_name string required Resource name of the Meet space to retrieve (e.g., 'spaces/abc123').

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

message_id string required Unique Gmail message ID

format string optional Format of the returned message.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

form_id string required The ID of the Google Form

response_id string required The 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.

Name Type Required Description

send_as_email string required The 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_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

thread_id string required Unique Gmail thread ID

format string optional Format of messages in the returned thread.

metadata_headers array optional Specific email headers to include when format is metadata

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

range string required Cell range to read in A1 notation

spreadsheet_id string required The ID of the Google Sheet

major_dimension string optional Whether values are returned by rows or columns

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional tool version to use for execution

value_render_option string optional How 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.

Name Type Required Description

matter_id string required Unique ID of the Vault matter to retrieve (e.g., '0123456789abcdef').

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional tool version to use for execution

view string optional Level 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.

Name Type Required Description

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

user_key string required User email address or unique user ID to retrieve activity for. Use 'all' to retrieve activities for all users.

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

event_name string optional Filter by a specific event name within the application (e.g., 'LOGIN_SUCCESS' for the login application).

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

max_results integer optional Maximum number of activity records to return per page (1–1000).

page_token string optional Token for the next page of results from a previous response.

schema_version string optional Optional schema version to use for tool execution

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

tool_version string optional Optional 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.

Name Type Required Description

customer string optional Customer ID or 'my_customer' for the authenticated account's domain (default: 'my_customer').

domain string optional Domain name to filter groups (e.g., 'example.com').

max_results integer optional Maximum number of groups to return per page (1–200).

page_token string optional Token for the next page of results from a previous response.

query string optional Query string to filter groups (e.g., 'name:Engineering*').

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional tool version to use for execution

user_key string optional Filter 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.

Name Type Required Description

customer string optional Customer ID or 'my_customer' for the authenticated account's domain (default: 'my_customer').

domain string optional Domain name to filter users (e.g., 'example.com'). Mutually exclusive with customer.

max_results integer optional Maximum number of users to return per page (1–500).

order_by string optional Field to sort users by. One of: 'email', 'familyName', 'givenName'.

page_token string optional Token for the next page of results from a previous response.

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

schema_version string optional Optional schema version to use for tool execution

show_deleted string optional If 'true', retrieves deleted users. Default is 'false'.

sort_order string optional Sort direction for results. One of: 'ASCENDING', 'DESCENDING'.

tool_version string optional Optional 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.

Name Type Required Description

alert_id string required The unique identifier of the alert whose feedback to list. Example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

filter string optional Filter string to narrow alert results. Example: "type=\"Suspicious login\""

order_by string optional Sort order for results. Example: 'createTime desc'

page_size integer optional Maximum number of alerts to return per page. Max 100.

page_token string optional Token for the next page of results from a previous response.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

max_results integer optional Maximum number of calendars to fetch

min_access_role string optional Minimum access role to include in results

page_token string optional Token to retrieve the next page of results

schema_version string optional Optional schema version to use for tool execution

show_deleted boolean optional Include deleted calendars in the list

show_hidden boolean optional Include calendars that are hidden from the calendar list

sync_token string optional Token to get updates since the last sync

tool_version string optional Optional 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.

Name Type Required Description

space_name string required Resource name of the Chat space to list members for (e.g., 'spaces/AAAABBBBCCCC').

filter string optional Query filter for members. Example: 'member.type = "HUMAN"'.

page_size integer optional Maximum number of members to return per page (1–1000).

page_token string optional Token for the next page of results from a previous response.

schema_version string optional Optional schema version to use for tool execution

show_groups boolean optional If true, include Google Groups in the member list.

show_invited boolean optional If true, include invited (pending) members in the results.

tool_version string optional Optional 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.

Name Type Required Description

space_name string required Resource name of the Chat space to list messages from (e.g., 'spaces/AAAABBBBCCCC').

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

order_by string optional Sort field and direction for results (e.g., 'createTime asc' or 'createTime desc').

page_size integer optional Maximum number of messages to return per page (1–1000).

page_token string optional Token for the next page of results from a previous response.

schema_version string optional Optional schema version to use for tool execution

show_deleted boolean optional If true, include deleted messages in the results.

tool_version string optional Optional 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.

Name Type Required Description

filter string optional Query filter for spaces. Example: 'spaceType = "SPACE"' or 'spaceType = "GROUP_CHAT"'.

page_size integer optional Maximum number of spaces to return per page (1–1000).

page_token string optional Token for the next page of results from a previous response.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

order_by string optional Sort order for results. Examples: modifiedTime desc, name asc, createdTime desc

page_size integer optional Number of documents to return per page (max 1000, default 100)

page_token string optional Token for retrieving the next page of results. Use the nextPageToken from a previous response.

query string optional Drive 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.

Name Type Required Description

max_results integer optional Maximum number of drafts to fetch

page_token string optional Page token for pagination

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

calendar_id string optional Calendar ID to list events from

max_results integer optional Maximum number of events to fetch

order_by string optional Order of events in the result

page_token string optional Page token for pagination

query string optional Free text search query

schema_version string optional Optional schema version to use for tool execution

single_events boolean optional Expand recurring events into single events

time_max string optional Upper bound for event start time (RFC3339 timestamp)

time_min string optional Lower bound for event start time (RFC3339 timestamp)

tool_version string optional Optional 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.

Name Type Required Description

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

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

include_derived_membership boolean optional If true, include members inherited from sub-groups or nested groups.

max_results integer optional Maximum number of members to return per page (1–200).

page_token string optional Token for the next page of results from a previous response.

roles string optional Filter members by role. Comma-separated values from: 'OWNER', 'MANAGER', 'MEMBER'.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

filter string optional Filter expression for notes. Example: 'trashed = false' or 'trashed = true'.

page_size integer optional Maximum number of notes to return per page (1–100).

page_token string optional Token for the next page of results from a previous response.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

customer_id string optional Customer ID or 'my_customer' for the authenticated account's domain (default: 'my_customer').

org_unit_path string optional Full path of the parent organizational unit to list children of (e.g., '/Engineering').

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional tool version to use for execution

type string optional Type 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.

Name Type Required Description

form_id string required The ID of the Google Form to list responses for

filter string optional Filter responses by submission time. Format: timestamp > 2026-01-01T00:00:00Z

page_size integer optional Maximum number of responses to return (max 5000)

page_token string optional Token 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.

Name Type Required Description

max_results integer optional Maximum number of task lists to return. Accepted value is between 1 and 100.

page_token string optional Token specifying the page of results to return. Obtained from nextPageToken in a previous response.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

task_list_id string required The ID of the task list to retrieve tasks from.

due_max string optional Upper bound for a task's due date (RFC3339 datetime). Tasks due after this datetime are excluded.

due_min string optional Lower bound for a task's due date (RFC3339 datetime). Tasks due before this datetime are excluded.

max_results integer optional Maximum number of tasks to return. Accepted value is between 1 and 100.

page_token string optional Token specifying the page of results to return. Obtained from nextPageToken in a previous response.

schema_version string optional Optional schema version to use for tool execution

show_completed boolean optional Flag indicating whether completed tasks are returned. The default is true.

show_deleted boolean optional Flag indicating whether deleted tasks are returned. The default is false.

show_hidden boolean optional Flag indicating whether hidden tasks are returned. The default is false.

tool_version string optional Optional 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.

Name Type Required Description

include_spam_trash boolean optional Whether to include threads from Spam and Trash

label_ids array optional Gmail label IDs to filter threads (threads must match all labels)

max_results integer optional Maximum number of threads to return

page_token string optional Page token for pagination

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

page_size integer optional Maximum number of matters to return per page (1–100).

page_token string optional Token for the next page of results from a previous response.

schema_version string optional Optional schema version to use for tool execution

state string optional Filter matters by state. One of: 'OPEN', 'CLOSED', 'DELETED'.

tool_version string optional Optional tool version to use for execution

view string optional Level 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.

Name Type Required Description

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

add_label_ids array optional List 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_ids array optional List of label IDs to remove from the message. Use system labels such as 'UNREAD', 'STARRED', 'INBOX', or custom label IDs. Example: ["UNREAD"].

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

file_id string required ID of the file or folder to move

new_parent_id string required ID of the destination folder to move the file into

name string optional Optional new name for the file after moving. If omitted, the file keeps its current name.

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

ancestor_name string optional Restrict activity to items under this folder. Format: 'items/FOLDER_ID'. Example: 'items/0B_abc123xyz'

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

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

item_name string optional Restrict activity to a specific file or folder. Format: 'items/FILE_ID'. Example: 'items/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms'

page_size integer optional Maximum number of activity records to return per page. Max 100.

page_token string optional Token for the next page of results from a previous response.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

document_id string required The ID of the Google Doc to read

schema_version string optional Optional schema version to use for tool execution

suggestions_view_mode string optional How suggestions are rendered in the response

tool_version string optional Optional 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.

Name Type Required Description

presentation_id string required The ID of the Google Slides presentation to read

fields string optional Fields to include in the response

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

spreadsheet_id string required The ID of the Google Sheet to read

include_grid_data boolean optional Include cell data in the response

ranges string optional Cell range to read in A1 notation

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

search_term string required Text to search for inside file contents

fields string optional Fields to include in the response

mime_type string optional Filter results by MIME type

page_size integer optional Number of files to return per page

page_token string optional Token for the next page of results

schema_version string optional Optional schema version to use for tool execution

supports_all_drives boolean optional Include shared drives in results

tool_version string optional Optional 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.

Name Type Required Description

fields string optional Fields to include in the response

order_by string optional Sort order for results

page_size integer optional Number of files to return per page

page_token string optional Token for the next page of results

query string optional Drive search query string

schema_version string optional Optional schema version to use for tool execution

supports_all_drives boolean optional Include shared drives in results

tool_version string optional Optional 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.

Name Type Required Description

query string required Text query to search people (e.g., name, email address).

other_contacts boolean optional Whether to include people not in the user's contacts (from 'Other Contacts').

page_size integer optional Maximum number of people to return.

person_fields array optional Fields to retrieve for each person.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

file_id string required ID of the file or folder to share

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

type string required The type of principal to share with. One of: 'user', 'group', 'domain', 'anyone'.

domain string optional The domain to share with. Required when type is 'domain'. Example: 'example.com'.

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

email_message string optional Custom message to include in the notification email sent to the recipient.

schema_version string optional Optional schema version to use for tool execution

send_notification_email boolean optional Whether to send a notification email to the recipient. Defaults to true.

tool_version string optional Optional tool version to use for execution

transfer_ownership boolean optional Whether 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.

Name Type Required Description

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

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

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

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

email string optional Updated email address for the contact (e.g., newemail@example.com).

family_name string optional Updated family (last) name of the contact.

given_name string optional Updated given (first) name of the contact.

phone_number string optional Updated phone number for the contact (e.g., +1-555-555-5555).

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional 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.

Name Type Required Description

document_id string required The ID of the Google Doc to update

requests array required Array of update requests to apply to the document

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional tool version to use for execution

write_control object optional Optional 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.

Name Type Required Description

calendar_id string required Calendar ID containing the event

event_id string required The ID of the calendar event to update

attendees_emails array optional Attendee email addresses

create_meeting_room boolean optional Generate a Google Meet link for this event

description string optional Optional event description

end_datetime string optional Event end time in RFC3339 format

event_duration_hour integer optional Duration of event in hours

event_duration_minutes integer optional Duration of event in minutes

event_type string optional Event type for display purposes

guests_can_invite_others boolean optional Allow guests to invite others

guests_can_modify boolean optional Allow guests to modify the event

guests_can_see_other_guests boolean optional Allow guests to see each other

location string optional Location of the event

recurrence array optional Recurrence rules (iCalendar RRULE format)

schema_version string optional Optional schema version to use for tool execution

send_updates boolean optional Send update notifications to attendees

start_datetime string optional Event start time in RFC3339 format

summary string optional Event title/summary

timezone string optional Timezone for the event (IANA time zone identifier)

tool_version string optional Optional tool version to use for execution

transparency string optional Calendar transparency (free/busy)

visibility string optional Visibility 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.

Name Type Required Description

group_email string required The email address of the Google Workspace group to update. Example: 'engineering@example.com'

allow_external_members boolean optional Whether members outside the domain can join the group. True to allow external members, false to restrict to domain only.

is_archived boolean optional Whether the group is archived. Archived groups cannot receive new messages.

message_moderation_level string optional Moderation level for messages posted to the group. Valid values: 'MODERATE_ALL_MESSAGES', 'MODERATE_NON_MEMBERS', 'MODERATE_NEW_MEMBERS', 'MODERATE_NONE'.

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional tool version to use for execution

who_can_join string optional Permission to join the group. Valid values: 'ANYONE_CAN_JOIN', 'ALL_IN_DOMAIN_CAN_JOIN', 'INVITED_CAN_JOIN', 'CAN_REQUEST_TO_JOIN'.

who_can_post_message string optional Permission 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_group string optional Permission 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_membership string optional Permission 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.

Name Type Required Description

send_as_email string required The 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_name string optional The display name shown as the sender name for this alias (e.g., 'Jane Smith').

is_default boolean optional If true, sets this send-as alias as the default address used when composing new messages.

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

schema_version string optional Optional schema version to use for tool execution

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

tool_version string optional Optional 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.

Name Type Required Description

task_id string required The ID of the task to update.

task_list_id string required The ID of the task list containing the task.

due string optional Updated 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.

notes string optional Updated notes or description for the task.

schema_version string optional Optional schema version to use for tool execution

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

title string optional Updated title of the task.

tool_version string optional Optional 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.

Name Type Required Description

enable_auto_reply boolean required Whether to enable the vacation auto-reply. Set to true to turn on out-of-office responses, false to disable.

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

response_body_html string optional HTML 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_text string optional Plain text body of the vacation auto-reply message.

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

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

restrict_to_domain boolean optional If true, only users in the same Google Workspace domain will receive the auto-reply. Default is false.

schema_version string optional Optional schema version to use for tool execution

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

tool_version string optional Optional 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.

Name Type Required Description

range string required Cell range to update in A1 notation

spreadsheet_id string required The ID of the Google Sheet to update

values array required 2D array of values to write to the range

include_values_in_response boolean optional Return the updated cell values in the response

schema_version string optional Optional schema version to use for tool execution

tool_version string optional Optional tool version to use for execution

value_input_option string optional How input values should be interpreted