PluginBench
Skill
Review
Audit score 70

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
Prerequisites
  • Google Workspace CLI (gws) installed
  • Authentication configured via gws-shared skill
  • Appropriate Google Forms API permissions
Claude Code
Cursor
Windsurf
Cline

How to use gws-forms

  1. 1.Run `gws forms --help` to browse available resources and methods
  2. 2.Use `gws schema forms.<resource>.<method>` to inspect required parameters and types
  3. 3.Build your command with `gws forms <resource> <method>` plus `--params` or `--json` flags
  4. 4.For batch updates, use `batchUpdate` to apply multiple changes at once
  5. 5.For new forms, call `create` first with title, then `batchUpdate` to add items

Use cases

Good for
  • 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
Who it's for
  • Google Workspace administrators
  • Automation engineers
  • Workflow developers
  • Data analysts working with Google Forms

gws-forms FAQ

Can I create a form with items in one call?

No. You must first call forms.create with the title, then use forms.batchUpdate to add items and configure the form.

What fields are preserved when creating a form?

Only form.info.title and form.info.document_title are copied. Description, items, and settings must be added separately via batchUpdate.

How do I discover what parameters a method needs?

Run `gws schema forms.<resource>.<method>` to see required params, their types, and defaults.

Can I monitor form changes?

Yes, use the 'watches' resource to set up notifications for form changes.

Do legacy forms work with this skill?

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.md for auth, global flags, and security rules. If missing, run gws generate-skills to 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 the publish_settings field.
  • responses — Operations on the 'responses' resource
  • watches — 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.