How do I install gws-apps-script?

Run `npx skills add https://github.com/googleworkspace/cli --skill gws-apps-script` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does gws-apps-script support?

gws-apps-script works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is gws-apps-script free to use?

Yes. gws-apps-script is free to install and use. It is available from the open Skills registry published by googleworkspace.

Productivity

gws-apps-script▌

Name: gws-apps-script
Availability: InStock
Author: googleworkspace

googleworkspace/cli · updated Apr 8, 2026

$npx skills add https://github.com/googleworkspace/cli --skill gws-apps-script

summary

Manage and execute Google Apps Script projects via CLI with direct API access.

›Supports core operations: create projects, retrieve metadata and content, update script files, and execute scripts via the run method
›Includes process monitoring to list execution history and status for individual scripts or user-initiated processes
›Provides deployment and versioning operations for managing script releases
›Requires gws binary and authentication setup defined in shared skill documentatio

skill.md

apps-script (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws apps-script <resource> <method> [flags]

Helper Commands

Command	Description
`+push`	Upload local files to an Apps Script project

API Resources

processes

list — List information about processes made by or on behalf of a user, such as process type and current status.
listScriptProcesses — List information about a script's executed processes, such as process type and current status.

projects

create — Creates a new, empty script project with no script files and a base manifest file.
get — Gets a script project's metadata.
getContent — Gets the content of the script project, including the code source and metadata for each script file.
getMetrics — Get metrics data for scripts, such as number of executions and active users.
updateContent — Updates the content of the specified script project. This content is stored as the HEAD version, and is used when the script is executed as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. This clears all the existing files in the project.
deployments — Operations on the 'deployments' resource
versions — Operations on the 'versions' resource

scripts

run —

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws apps-script --help

# Inspect a method's required params, types, and defaults
gws schema apps-script.<resource>.<method>

Use gws schema output to build your --params and --json flags.