gws

Show upcoming calendar events

Send messages and manage Google Chat spaces

Read, create, and append content to Google Docs documents

Search, upload, download, and share Google Drive files and folders

List and read Google Keep notes

Search and look up Google Contacts and directory profiles

Read, write, and append data to Google Sheets spreadsheets

Read and create Google Slides presentations

Generate a standup report combining today's calendar and tasks

List, create, complete, and manage Google Tasks

Prepare for your next meeting with agenda and attendees

Send an email via Google Workspace CLI

Generate a standup report from Google Workspace data

Show unread email inbox summary

Upload a file to Google Drive

Use this agent when the user wants to operate as a Content Creator — create, organize, and distribute content across Google Workspace. Services: docs, drive, gmail, chat, slides. <example> Context: User wants to create and share content user: "Draft a blog post in Google Docs and share it with the team for review" assistant: "I'll use the content-creator agent to draft and share." </example> <example> Context: User needs to organize content assets user: "Upload these media files to the content folder and announce in the team chat" assistant: "I'll use the content-creator agent to upload and announce." </example>

Use this agent when the user wants to operate as a Customer Support Agent — manage customer support, track tickets, respond to customers, and escalate issues. Services: gmail, sheets, chat, calendar. <example> Context: User needs to triage support inbox user: "Check the support inbox and log any new tickets to the tracking sheet" assistant: "I'll use the customer-support agent to triage and log tickets." </example> <example> Context: User wants to escalate an issue user: "Escalate this customer issue to the engineering team chat and schedule a follow-up call" assistant: "I'll use the customer-support agent to escalate and schedule." </example>

Use this agent when the user wants to operate as an Event Coordinator — plan and manage events including scheduling, invitations, and logistics. Services: calendar, gmail, drive, chat, sheets. <example> Context: User is planning a company event user: "Set up calendar events, send invitations, and create a shared folder for the offsite" assistant: "I'll use the event-coordinator agent to set up the event." </example> <example> Context: User needs to track RSVPs user: "Check RSVPs for the team dinner and update the tracking sheet" assistant: "I'll use the event-coordinator agent to check and update." </example>

Use this agent when the user wants to operate as an Executive Assistant — manage an executive's schedule, inbox, and communications. Services: gmail, calendar, drive, chat. <example> Context: User needs help managing an executive's day user: "Check my boss's calendar for today and triage their inbox" assistant: "I'll use the exec-assistant agent to handle this." </example> <example> Context: User wants meeting preparation user: "Prep me for my 2pm meeting and draft a follow-up email" assistant: "I'll use the exec-assistant agent to prepare and draft." </example>

Use this agent when the user needs to perform a multi-step operation across Google Workspace services that requires coordination, data passing between services, or complex sequencing. Examples: <example> Context: User wants to create a meeting and email attendees user: "Schedule a meeting with Alice and Bob for tomorrow at 2pm and email them the agenda" assistant: "I'll use the gws-orchestrator agent to coordinate creating the event and sending the emails." </example> <example> Context: User wants to process emails into tasks user: "Go through my unread emails from my manager and create tasks for any action items" assistant: "I'll use the gws-orchestrator agent to triage emails and convert relevant ones to tasks." </example> <example> Context: User wants to build a report from multiple sources user: "Create a spreadsheet summarizing this week's meetings and share it in our team chat" assistant: "I'll use the gws-orchestrator agent to gather calendar data, create the spreadsheet, and announce it." </example> <example> Context: User wants to upload and share a file user: "Upload this report to the shared drive folder and send an email to the team with the link" assistant: "I'll use the gws-orchestrator agent to upload the file and send the notification email." </example>

Use this agent when the user wants to operate as an HR Coordinator — handle HR workflows including onboarding, announcements, and employee comms. Services: gmail, calendar, drive, chat. <example> Context: User is onboarding a new hire user: "Set up orientation sessions and share onboarding docs for our new engineer" assistant: "I'll use the hr-coordinator agent to set up onboarding." </example> <example> Context: User needs to send an HR announcement user: "Announce the new PTO policy to the whole team via email and chat" assistant: "I'll use the hr-coordinator agent to send the announcement." </example>

Use this agent when the user wants to operate as an IT Administrator — administer IT, monitor security, and configure Google Workspace. Services: gmail, drive, calendar. <example> Context: User needs to review IT security user: "Check for any suspicious login activity and review Drive sharing policies" assistant: "I'll use the it-admin agent to review security settings." </example> <example> Context: User wants to manage workspace configuration user: "Review our current auth status and check pending IT requests" assistant: "I'll use the it-admin agent to review the configuration." </example>

Use this agent when the user wants to operate as a Project Manager — coordinate projects, track tasks, schedule meetings, and share docs. Services: drive, sheets, calendar, gmail, chat. <example> Context: User wants to track project status user: "Log this week's sprint progress and send a status update to stakeholders" assistant: "I'll use the project-manager agent to log progress and send the update." </example> <example> Context: User needs to share project artifacts user: "Upload the design doc to the shared drive and announce it in the team chat" assistant: "I'll use the project-manager agent to upload and announce." </example>

Use this agent when the user wants to operate as a Researcher — organize research, manage references, notes, and collaboration. Services: drive, docs, sheets, gmail. <example> Context: User wants to organize research materials user: "Create a research notes doc and log my experiment data in the tracking sheet" assistant: "I'll use the researcher agent to create the doc and log data." </example> <example> Context: User needs to share findings user: "Share my research findings with the team and request peer review" assistant: "I'll use the researcher agent to share and request review." </example>

Use this agent when the user wants to operate as Sales Operations — manage sales workflows, track deals, schedule calls, and handle client comms. Services: gmail, calendar, sheets, drive. <example> Context: User needs to prepare for a client call user: "Prep me for my call with Acme Corp and log the deal status" assistant: "I'll use the sales-ops agent to prepare and log the update." </example> <example> Context: User wants a pipeline summary user: "Give me this week's sales pipeline summary" assistant: "I'll use the sales-ops agent to generate the summary." </example>

Use this agent when the user wants to operate as a Team Lead — run standups, coordinate tasks, and communicate with the team. Services: calendar, gmail, chat, drive, sheets. <example> Context: User wants to run their daily standup user: "Run the standup and share the output in our team chat" assistant: "I'll use the team-lead agent to run and share the standup." </example> <example> Context: User needs to prepare for 1:1s user: "Prep for my 1:1s this afternoon and create action items from last week's emails" assistant: "I'll use the team-lead agent to prep and create action items." </example>

Google Workspace Admin SDK: Audit logs and usage reports.

Security rules for AI agents using gws — input validation, path safety, URL encoding, and Model Armor sanitization.

Authenticate and manage credentials for the gws CLI — login, logout, status, scopes, service accounts, and credential storage.

Google Calendar: Show upcoming events across all calendars.

Google Calendar: Create a new event.

Google Calendar: Manage calendars and events.

Google Chat: Send a message to a space.

Google Chat: Manage Chat spaces and messages.

Google Classroom: Manage classes, rosters, and coursework.

Google Docs: Append text to a document.

Read and write Google Docs.

Google Drive: Upload a file with automatic metadata.

Google Drive: Manage files, folders, and shared drives.

Google Workspace Events: Renew/reactivate Workspace Events subscriptions.

Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.

Subscribe to Google Workspace events.

Read and write Google Forms.

Gmail: Forward a message to new recipients.

Gmail: Reply-all to a message (handles threading automatically).

Gmail: Reply to a message (handles threading automatically).

Gmail: Send an email.

Gmail: Show unread inbox summary (sender, subject, date).

Gmail: Watch for new emails and stream them as NDJSON.

Gmail: Send, read, and manage email.

Manage Google Keep notes.

Manage Google Meet conferences.

Google Model Armor: Create a new Model Armor template.

Google Model Armor: Sanitize a user prompt through a Model Armor template.

Google Model Armor: Sanitize a model response through a Model Armor template.

Google Model Armor: Filter user-generated content for safety.

Google People: Manage contacts and profiles.

Quick reference for gws CLI syntax — core patterns, key flags, pagination, field masks, and output formats.

Introspect any Google Workspace API schema — discover method parameters, request bodies, and response types before executing.

Apps Script: Deploy and manage Google Apps Script projects with gws script +push.

gws CLI: Shared patterns for authentication, global flags, and output formatting.

Google Sheets: Append a row to a spreadsheet.

Google Sheets: Read values from a spreadsheet.

Google Sheets: Read and write spreadsheets.

Google Slides: Read and write presentations.

Google Tasks: Manage task lists and tasks.

Google Workflow: Convert a Gmail message into a Google Tasks entry.

Google Workflow: Announce a Drive file in a Chat space.

Google Workflow: Prepare for your next meeting: agenda, attendees, and linked docs.

Google Workflow: Today's meetings + open tasks as a standup summary.

Google Workflow: Weekly summary: this week's meetings + unread email count.

Google Workflow: Cross-service productivity workflows.

Create, organize, and distribute content across Workspace.

Manage customer support — track tickets, respond, escalate issues.

Plan and manage events — scheduling, invitations, and logistics.

Manage an executive's schedule, inbox, and communications.

Handle HR workflows — onboarding, announcements, and employee comms.

Administer IT — monitor security and configure Workspace.

Coordinate projects — track tasks, schedule meetings, and share docs.

Organize research — manage references, notes, and collaboration.

Manage sales workflows — track deals, schedule calls, client comms.

Lead a team — run standups, coordinate tasks, and communicate.

Export a Google Sheets spreadsheet as a CSV file for local backup or processing.

Add a list of attendees to an existing Google Calendar event and send notifications.

Create recurring focus time blocks on Google Calendar to protect deep work hours.

List and download all files from a Google Drive folder.

Retrieve and review responses from a Google Form.

Read data from two tabs in a Google Sheet to compare and identify differences.

Duplicate a Google Sheets template tab for a new month of tracking.

Create a Google Classroom course and invite students.

Copy a Google Docs template, fill in content, and share with collaborators.

Read event data from a Google Sheets spreadsheet and create Google Calendar entries for each row.

Set up a Google Sheets spreadsheet for tracking expenses with headers and initial entries.

Create a Google Form for feedback and share it via Gmail.

Create a Gmail filter to automatically label, star, or categorize incoming messages.

Create a Google Meet meeting space and share the join link.

Create a new Google Slides presentation and add initial slides.

Create a Google Shared Drive and add members with appropriate roles.

Set up a new Google Tasks list with initial tasks.

Enable a Gmail out-of-office auto-reply with a custom message and date range.

Read content from a Google Doc and use it as the body of a Gmail message.

Share a Google Drive file and email the link with a message to recipients.

Query Google Calendar free/busy status for multiple users to find a meeting slot.

Identify large Google Drive files consuming storage quota.

Find Gmail messages with a specific label and forward them to another address.

Read data from a Google Sheet and create a formatted Google Docs report.

Apply Gmail labels to matching messages and archive them to keep your inbox clean.

Append a deal status update to a Google Sheets sales tracking spreadsheet.

Create a Google Drive folder structure and move files into the right locations.

Review your Google Calendar week, identify gaps, and add events to fill them.

Create a Google Docs post-mortem, schedule a Google Calendar review, and notify via Chat.

Move a Google Calendar event to a new time and automatically notify all attendees.

Review who attended a Google Meet conference and for how long.

Find Google Tasks that are past due and need attention.

Find Gmail messages with attachments and save them to a Google Drive folder.

Save a Gmail message body into a Google Doc for archival or reference.

Create a recurring Google Calendar event with attendees.

Discover and introspect any Google Workspace API before using it — explore methods, parameters, and types.

Send a team announcement via both Gmail and a Google Chat space.

Configure Google Cloud Model Armor globally for all gws commands to protect against prompt injection in API responses.

Share a Google Docs document with edit access and email collaborators the link.

Share Google Drive files with all attendees of a Google Calendar event.

Share a Google Drive folder and all its contents with a list of collaborators.

Stream real-time Gmail notifications using gws gmail +watch for continuous inbox monitoring.

Export Google Contacts directory to a Google Sheets spreadsheet.

Subscribe to change notifications on a Google Drive file or folder.

1 hook across 1 event