> **Building with AI coding agents?** If you're using an AI coding agent, install the official Scalekit plugin. It gives your agent full awareness of the Scalekit API — reducing hallucinations and enabling faster, more accurate code generation. > > - **Claude Code**: `/plugin marketplace add scalekit-inc/claude-code-authstack` then `/plugin install @scalekit-auth-stack` > - **GitHub Copilot CLI**: `copilot plugin marketplace add scalekit-inc/github-copilot-authstack` then `copilot plugin install @scalekit-auth-stack` > - **Codex**: run the bash installer, restart, then open Plugin Directory and enable `` > - **Skills CLI** (Windsurf, Cline, 40+ agents): `npx skills add scalekit-inc/skills --list` then `--skill ` > > `` / ``: `agentkit`, `full-stack-auth`, `mcp-auth`, `modular-sso`, `modular-scim` — [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/) --- # Google Workspace (DWD) connector Set up Google Workspace Domain-Wide Delegation to let your agent impersonate users through a service account — no per-user OAuth required. **Authentication:** Service Account (DWD) **Categories:** Productivity, Communication 1. ### Install the SDK ### Node.js ```bash frame="terminal" npm install @scalekit-sdk/node ``` ### Python ```bash frame="terminal" pip install scalekit ``` Full SDK reference: [Node.js](/agentkit/sdks/node/) | [Python](/agentkit/sdks/python/) 2. ### Set your credentials Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**. ```sh showLineNumbers=false title=".env" SCALEKIT_ENVIRONMENT_URL= SCALEKIT_CLIENT_ID= SCALEKIT_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](https://app.scalekit.com), 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](https://developers.google.com/identity/protocols/oauth2/scopes) for the full list. 2. ### Create a GCP service account - Go to [Google Cloud Console](https://console.cloud.google.com) → **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](https://console.cloud.google.com), 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](https://app.scalekit.com), 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. > caution: 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](https://admin.google.com) 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 export const sectionTitle = '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 export const sectionTitle = '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. > note: 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 ```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 export const sectionTitle = '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 ```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. ## Tool list ### `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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 '. - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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. Parameters: - `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., 'Jane Smith
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. Parameters: - `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. Parameters: - `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. Parameters: - `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 --- ## More Scalekit documentation | Resource | What it contains | When to use it | |----------|-----------------|----------------| | [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content | | [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas | | [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |