gws-forms
googleworkspace/cli
Read and write Google Forms via CLI with batch updates and response management.
What is gws-forms?
Access Google Forms programmatically through the Google Workspace CLI. Create forms, retrieve form data, update form settings, manage responses, and set publish settings using command-line API calls.
- Create new forms with titles and document titles
- Retrieve complete form data and structure
- Batch update forms with multiple changes in one call
- Manage form responses and response data
- Configure publish settings for forms
- Set up watches for form change notifications
How to install gws-forms
npx skills add null --skill gws-forms- Google Workspace CLI (gws) installed
- Authentication configured via gws-shared skill
- Appropriate Google Forms API permissions
How to use gws-forms
- 1.Run `gws forms --help` to browse available resources and methods
- 2.Use `gws schema forms.<resource>.<method>` to inspect required parameters and types
- 3.Build your command with `gws forms <resource> <method>` plus `--params` or `--json` flags
- 4.For batch updates, use `batchUpdate` to apply multiple changes at once
- 5.For new forms, call `create` first with title, then `batchUpdate` to add items
Use cases
- Automate form creation and configuration in bulk
- Extract form responses for analysis or reporting
- Update form questions and settings programmatically
- Monitor form changes with watch notifications
- Integrate form data into automated workflows
- Google Workspace administrators
- Automation engineers
- Workflow developers
- Data analysts working with Google Forms
gws-forms FAQ
No. You must first call forms.create with the title, then use forms.batchUpdate to add items and configure the form.
Only form.info.title and form.info.document_title are copied. Description, items, and settings must be added separately via batchUpdate.
Run `gws schema forms.<resource>.<method>` to see required params, their types, and defaults.
Yes, use the 'watches' resource to set up notifications for form changes.
Legacy forms are not supported for publish settings, as they lack the publish_settings field.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: gws-forms description: "Read and write Google Forms." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws forms --help"
forms (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws forms <resource> <method> [flags]
API Resources
forms
batchUpdate— Change the form with a batch of updates.create— Create a new form using the title given in the provided form message in the request. Important: Only the form.info.title and form.info.document_title fields are copied to the new form. All other fields including the form description, items and settings are disallowed. To create a new form and add items, you must first call forms.create to create an empty form with a title and (optional) document title, and then call forms.update to add the items.get— Get a form.setPublishSettings— Updates the publish settings of a form. Legacy forms aren't supported because they don't have thepublish_settingsfield.responses— Operations on the 'responses' resourcewatches— Operations on the 'watches' resource
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws forms --help
# Inspect a method's required params, types, and defaults
gws schema forms.<resource>.<method>
Use gws schema output to build your --params and --json flags.
Related skills
More from googleworkspace/cli and the wider catalog.
gws-gmail
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.