googleworkspace

gws-docs

"Read and write Google Docs."

googleworkspace 30,672 1,799 Updated 5mo ago
GitHub

Install

npx skillscat add googleworkspace/cli/gws-docs

Install via the SkillsCat registry.

About this skill

This skill provides read and write access to Google Docs through the gws CLI tool. It allows agents to retrieve document contents, create new documents, and apply batch updates to existing documents. Developers should use this skill when they need to programmatically interact with Google Docs as part of an automated workflow or agent task.

SKILL.md

docs (v1)

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

gws docs <resource> <method> [flags]

Helper Commands

Command Description
`+write` Append text to a document

API Resources

documents

  • batchUpdate — Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests.
  • create — Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document.
  • get — Gets the latest version of the specified document.

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws docs --help

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

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