Google Workspace CLI skills

Teaches your agent the gws command line for Gmail, Calendar, Drive, Sheets, Docs and Chat, with ready-made workflows and recipes.

Pack · 82 skills

About

Ratings and reviews

What Google Workspace CLI skills does

About

The Google Workspace CLI skills are the Agent Skills that ship with gws, the Google Workspace command line. They teach your agent which gws commands to run for everyday Workspace jobs, from triaging your inbox to preparing for your next meeting. gws builds its commands from Google's Discovery Service and returns structured JSON, so your agent can read every result. What's in the pack - Helper skills: send, reply to, forward and read email, summarise unread mail, show your agenda, create events, read and append Sheets rows, add text to a Doc, upload to Drive and post to a Chat space - Workflows: a standup report, meeting prep, a weekly digest, turning an email into a task, and announcing a Drive file in Chat - Recipes: step-by-step jobs such as finding free time across calendars, rescheduling a meeting, saving email attachments to Drive, creating a doc from a template and blocking focus time - Personas: role bundles for an executive assistant, project manager, sales ops, IT admin, team lead and more - A shared skill for sign-in, global flags such as --dry-run and safety rules, plus skills for Apps Script, Workspace events, Admin audit reports and Model Armor How to install it The skills need the gws command line on the machine where your agent runs commands. Install gws from its GitHub releases, with npm install -g @googleworkspace/cli, or with brew install googleworkspace-cli. Then sign in once with gws auth setup, which uses the gcloud CLI to create a Google Cloud project and enable the APIs (without gcloud, create an OAuth client in the Cloud Console and run gws auth login). Google's own command, npx skills add https://github.com/googleworkspace/cli, adds every skill in the repo, including the per-API skills for Drive, Gmail, Calendar and the rest. In Gemini CLI, the Google Workspace CLI extension adds gws's commands and these skills in one step. Good to know - The shared skill tells your agent to confirm with you before any write or delete, and to prefer --dry-run for destructive commands - If your OAuth app is in testing mode, sign in to just the services you need, for example gws auth login -s drive,gmail,calendar - Responses can be screened through Google Cloud Model Armor - It comes from the googleworkspace team on GitHub but isn't an officially supported Google product, and it's under active development, so expect changes

Things to ask it

Once it’s added

“Summarise my unread email.”
“What's on my calendar today?”
“Prepare me for my next meeting.”
“Give me a standup report of today's meetings and open tasks.”
“Find a free 30-minute slot for Priya, Sam and me on Tuesday and book it.”
“Save the attachments from this week's invoice emails to a Drive folder.”

What it can do

Before you add it

Reads only

Your inbox, agenda and free/busy times · Sheets values, Docs, Drive files and Form responses

Makes changes · your agent can ask first

Sends, replies to and forwards email · Creates and reschedules calendar events · Appends Sheets rows, writes Docs and uploads to Drive · Posts to Chat spaces and creates tasks

Skills in Google Workspace CLI skills

Pack · 82 skills, each with its own page

gws-admin-reportsSecurity scan passedGoogle Workspace Admin SDK: Audit logs and usage reports.
gws-calendar-agendaSecurity scan passedGoogle Calendar: Show upcoming events across all calendars.
gws-calendar-insertSecurity scan passedGoogle Calendar: Create a new event.
gws-chat-sendSecurity scan passedGoogle Chat: Send a message to a space.
gws-docs-writeSecurity scan passedGoogle Docs: Append text to a document.
gws-drive-uploadSecurity scan passedGoogle Drive: Upload a file with automatic metadata.
gws-eventsSecurity scan passedSubscribe to Google Workspace events.
gws-events-renewSecurity scan passedGoogle Workspace Events: Renew/reactivate Workspace Events subscriptions.
gws-events-subscribeSecurity scan passedGoogle Workspace Events: Subscribe to Workspace events and stream them as NDJSON.
gws-gmail-forwardSecurity scan passedGmail: Forward a message to new recipients.
gws-gmail-readSecurity scan passedGmail: Read a message and extract its body or headers.
gws-gmail-replySecurity scan passedGmail: Reply to a message (handles threading automatically).
gws-gmail-reply-allSecurity scan passedGmail: Reply-all to a message (handles threading automatically).
gws-gmail-sendSecurity scan passedGmail: Send an email.
gws-gmail-triageSecurity scan passedGmail: Show unread inbox summary (sender, subject, date).
gws-gmail-watchSecurity scan passedGmail: Watch for new emails and stream them as NDJSON.
gws-modelarmorSecurity scan passedGoogle Model Armor: Filter user-generated content for safety.
gws-modelarmor-create-templateSecurity scan passedGoogle Model Armor: Create a new Model Armor template.
gws-modelarmor-sanitize-promptSecurity scan passedGoogle Model Armor: Sanitize a user prompt through a Model Armor template.
gws-modelarmor-sanitize-responseSecurity scan passedGoogle Model Armor: Sanitize a model response through a Model Armor template.
gws-scriptSecurity scan passedManage Google Apps Script projects.
gws-script-pushSecurity scan passedGoogle Apps Script: Upload local files to an Apps Script project.
gws-sharedSecurity scan passedgws CLI: Shared patterns for authentication, global flags, and output formatting.
gws-sheets-appendSecurity scan passedGoogle Sheets: Append a row to a spreadsheet.
gws-sheets-readSecurity scan passedGoogle Sheets: Read values from a spreadsheet.
gws-workflowSecurity scan passedGoogle Workflow: Cross-service productivity workflows.
gws-workflow-email-to-taskSecurity scan passedGoogle Workflow: Convert a Gmail message into a Google Tasks entry.
gws-workflow-file-announceSecurity scan passedGoogle Workflow: Announce a Drive file in a Chat space.
gws-workflow-meeting-prepSecurity scan passedGoogle Workflow: Prepare for your next meeting: agenda, attendees, and linked docs.
gws-workflow-standup-reportSecurity scan passedGoogle Workflow: Today's meetings + open tasks as a standup summary.
gws-workflow-weekly-digestSecurity scan passedGoogle Workflow: Weekly summary: this week's meetings + unread email count.
persona-content-creatorSecurity scan passedCreate, organize, and distribute content across Workspace.
persona-customer-supportSecurity scan passedManage customer support — track tickets, respond, escalate issues.
persona-event-coordinatorSecurity scan passedPlan and manage events — scheduling, invitations, and logistics.
persona-exec-assistantSecurity scan passedManage an executive's schedule, inbox, and communications.
persona-hr-coordinatorSecurity scan passedHandle HR workflows — onboarding, announcements, and employee comms.
persona-it-adminSecurity scan passedAdminister IT — monitor security and configure Workspace.
persona-project-managerSecurity scan passedCoordinate projects — track tasks, schedule meetings, and share docs.
persona-researcherSecurity scan passedOrganize research — manage references, notes, and collaboration.
persona-sales-opsSecurity scan passedManage sales workflows — track deals, schedule calls, client comms.
persona-team-leadSecurity scan passedLead a team — run standups, coordinate tasks, and communicate.
recipe-backup-sheet-as-csvSecurity scan passedExport a Google Sheets spreadsheet as a CSV file for local backup or processing.
recipe-batch-invite-to-eventSecurity scan passedAdd a list of attendees to an existing Google Calendar event and send notifications.
recipe-block-focus-timeSecurity scan passedCreate recurring focus time blocks on Google Calendar to protect deep work hours.
recipe-bulk-download-folderSecurity scan passedList and download all files from a Google Drive folder.
recipe-collect-form-responsesSecurity scan passedRetrieve and review responses from a Google Form.
recipe-compare-sheet-tabsSecurity scan passedRead data from two tabs in a Google Sheet to compare and identify differences.
recipe-copy-sheet-for-new-monthSecurity scan passedDuplicate a Google Sheets template tab for a new month of tracking.
recipe-create-classroom-courseSecurity scan passedCreate a Google Classroom course and invite students.
recipe-create-doc-from-templateSecurity scan passedCopy a Google Docs template, fill in content, and share with collaborators.
recipe-create-events-from-sheetSecurity scan passedRead event data from a Google Sheets spreadsheet and create Google Calendar entries for each row.
recipe-create-expense-trackerSecurity scan passedSet up a Google Sheets spreadsheet for tracking expenses with headers and initial entries.
recipe-create-feedback-formSecurity scan passedCreate a Google Form for feedback and share it via Gmail.
recipe-create-gmail-filterSecurity scan passedCreate a Gmail filter to automatically label, star, or categorize incoming messages.
recipe-create-meet-spaceSecurity scan passedCreate a Google Meet meeting space and share the join link.
recipe-create-presentationSecurity scan passedCreate a new Google Slides presentation and add initial slides.
recipe-create-shared-driveSecurity scan passedCreate a Google Shared Drive and add members with appropriate roles.
recipe-create-task-listSecurity scan passedSet up a new Google Tasks list with initial tasks.
recipe-create-vacation-responderSecurity scan passedEnable a Gmail out-of-office auto-reply with a custom message and date range.
recipe-draft-email-from-docSecurity scan passedRead content from a Google Doc and use it as the body of a Gmail message.
recipe-email-drive-linkSecurity scan passedShare a Google Drive file and email the link with a message to recipients.
recipe-find-free-timeSecurity scan passedQuery Google Calendar free/busy status for multiple users to find a meeting slot.
recipe-find-large-filesSecurity scan passedIdentify large Google Drive files consuming storage quota.
recipe-forward-labeled-emailsSecurity scan passedFind Gmail messages with a specific label and forward them to another address.
recipe-generate-report-from-sheetSecurity scan passedRead data from a Google Sheet and create a formatted Google Docs report.
recipe-label-and-archive-emailsSecurity scan passedApply Gmail labels to matching messages and archive them to keep your inbox clean.
recipe-log-deal-updateSecurity scan passedAppend a deal status update to a Google Sheets sales tracking spreadsheet.
recipe-organize-drive-folderSecurity scan passedCreate a Google Drive folder structure and move files into the right locations.
recipe-plan-weekly-scheduleSecurity scan passedReview your Google Calendar week, identify gaps, and add events to fill them.
recipe-post-mortem-setupSecurity scan passedCreate a Google Docs post-mortem, schedule a Google Calendar review, and notify via Chat.
recipe-reschedule-meetingSecurity scan passedMove a Google Calendar event to a new time and automatically notify all attendees.
recipe-review-meet-participantsSecurity scan passedReview who attended a Google Meet conference and for how long.
recipe-review-overdue-tasksSecurity scan passedFind Google Tasks that are past due and need attention.
recipe-save-email-attachmentsSecurity scan passedFind Gmail messages with attachments and save them to a Google Drive folder.
recipe-save-email-to-docSecurity scan passedSave a Gmail message body into a Google Doc for archival or reference.
recipe-schedule-recurring-eventSecurity scan passedCreate a recurring Google Calendar event with attendees.
recipe-send-team-announcementSecurity scan passedSend a team announcement via both Gmail and a Google Chat space.
recipe-share-doc-and-notifySecurity scan passedShare a Google Docs document with edit access and email collaborators the link.
recipe-share-event-materialsSecurity scan passedShare Google Drive files with all attendees of a Google Calendar event.
recipe-share-folder-with-teamSecurity scan passedShare a Google Drive folder and all its contents with a list of collaborators.
recipe-sync-contacts-to-sheetSecurity scan passedExport Google Contacts directory to a Google Sheets spreadsheet.
recipe-watch-drive-changesSecurity scan passedSubscribe to change notifications on a Google Drive file or folder.

Install Google Workspace CLI skills

Your agent

Runs on your machine.

In ChatGPTDownload the cli folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the skills on GitHub

Runs on your machine.