gws-forms Skill: What It Does and How to Install It

Lets Claude create, read and change Google Forms, and change their publish settings, through the gws command-line tool.

Installs: 41.8K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

gws-forms teaches Claude the gws forms commands from the Google Workspace CLI. Claude can create a form, read one, change it with batchUpdate and update its publish settings. A new form copies only its title, so adding questions takes a second call. It needs the gws program signed in to your Google account, and its first instruction is to read the gws-shared skill.

Good for

People who build surveys and sign-up forms in Google Forms
Teams automating form setup
Claude Code users who already use the gws CLI for Workspace

Install gws-forms

Claude Code

Copy this prompt.

Install the gws-forms skill in Claude Code. Run this command:

npm install -g @googleworkspace/cli
gws auth setup
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-shared
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-forms

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18+, A Google Cloud project, A Google account.

The README says gws is not an officially supported Google product and is under active development, so expect breaking changes. If Google consent shows "hasn't verified this app" while your OAuth app is in testing mode, the README says to continue.

From the project README. Source.

What's in the skill

When it loads

Read and write Google Forms.

Sections in SKILL.md

API Resources
forms
Discovering Commands

Key facts

Author: googleworkspace
Repository: googleworkspace/cli
License: Apache-2.0
Skill version: 0.22.5
Installs on skills.sh: 41,798 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026)
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Files: 1 file: SKILL.md only
Needs: The gws program (SKILL.md lists it as a required binary) and the gws-shared skill
Status: The README says gws is not an officially supported Google product

What it includes

Creates a form with a title; questions and settings need a second call
SKILL.md says only the title fields are copied. To add items you create an empty form, then update it.
Write · gws forms forms create
Gets a form
Network · gws forms forms get
Changes a form with a batch of updates
Write · gws forms forms batchUpdate
Updates the publish settings of a form; legacy forms are not supported
Write · gws forms forms setPublishSettings
Operations on the responses resource of a form
gws forms forms responses
Operations on the watches resource of a form
gws forms forms watches
Shows a method's required parameters, types and defaults
Use its output to build the --params and --json flags.
Runs code · gws schema forms.<resource>.<method>

From the official docs

Permissions

Medium risk

It lets Claude create forms and change forms and their publish settings in your Google account through the gws command line. Sign in with the narrowest permissions you can and ask for --dry-run before any change.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can change a form and its publish settings
batchUpdate edits a form and setPublishSettings updates how it is published. Check what Claude proposes before you approve it, and ask for --dry-run first. github.com
Sign-in gives gws access to your Google account
gws auth login asks for Google permissions. The README shows how to choose individual services so the consent screen asks for fewer, so pick only what you need.
A responses resource is listed
SKILL.md names a responses resource without describing it. Run gws schema on it and check which permission it needs before Claude reads answers.
The gws program is under active development
The README warns to expect breaking changes before v1.0. Pin the version you tested.

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode is documented. The --dry-run flag shows a request without sending it.
Talks to	The gws program calls Google Workspace APIs. Your AI provider receives the data Claude reads from Google
Sign-in and keys	Sign-in is handled by the gws program. The README says credentials are encrypted at rest (AES-256-GCM) with the key in your OS keyring, or in ~/.config/gws/.encryption_key when the file backend is set.
Scopes	Claude runs the gws program on your machine gws signs in with your Google account and calls the Forms API

Questions

How do I install gws-forms?

Use the install box above. It installs the gws program, signs you in, and adds gws-shared and gws-forms.

Why does my new form come out empty?

SKILL.md says create copies only the title fields to the new form. Questions, description and settings are not copied, so Claude has to create the empty form first and then add items in a second call.

Does it need an API key?

Not in the usual sense. The README requires a Google Cloud project for OAuth credentials and a Google account.

Does gws-forms work in the Claude app?

The README documents no Claude app install. The skill drives a program on your machine, so use it in Claude Code or another local agent.

Is gws-forms safe?

It can create and change forms and their publish settings in your Google account. Sign in with the narrowest permissions you can, use --dry-run first and test on a copy. The skill file is one SKILL.md and bundles no scripts.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-forms

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

googleworkspace/cli README · github.com
gws-shared SKILL.md · github.com
googleworkspace/cli · github.com
skills CLI commands · github.com
gws-forms SKILL.md · github.com
gws-forms on skills.sh · skills.sh