Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
googleworkspace avatar

Gws Docs

  • 46.1k installs
  • 30k repo stars
  • Updated July 22, 2026
  • googleworkspace/cli

gws-docs is a CLI skill providing zero-boilerplate access to Google Docs APIs with structured JSON output.

About

gws-docs is a CLI skill that provides programmatic access to Google Docs without writing REST calls. It returns structured JSON output suitable for AI agents. The skill includes 40+ helper agents for document creation, editing, and manipulation workflows.

  • CLI for Google Docs with zero boilerplate and structured JSON output
  • 40+ agent skills for document operations and automation
  • Dynamic API surface from Google Discovery Service

Gws Docs by the numbers

  • 46,139 all-time installs (skills.sh)
  • +1,534 installs in the week ending Jul 28, 2026 (Skillselion tracking)
  • Ranked #20 of 690 Office & Documents skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

gws-docs capabilities & compatibility

Works with
google drive
Use cases
api development
Pricing
Free
npx skills add https://github.com/googleworkspace/cli --skill gws-docs

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs46.1k
repo stars30k
Security audit2 / 3 scanners passed
Last updatedJuly 22, 2026
Repositorygoogleworkspace/cli

How do you update Google Docs from the command line?

Access Google Docs programmatically via CLI with structured output for agent automation

Who is it for?

Developers building agents that need programmatic Docs access

Skip if: Manual document editing, UI-based workflows

When should I use this skill?

User asks to read, create, update, or append text in Google Docs via gws CLI or terminal automation.

What you get

Created or updated Google Docs, appended document text, and batchUpdate API changes applied from gws CLI.

  • updated google docs
  • appended document text via batchupdate

By the numbers

  • gws-docs skill version 0.22.5
  • Exposes documents.batchUpdate and +write helper commands via gws CLI

Files

SKILL.mdMarkdownGitHub ↗

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

CommandDescription
`+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.

Related skills

Forks & variants (2)

Gws Docs has 2 known copies in the catalog totaling 7 installs. They canonicalize to this original listing.

FAQ

What CLI commands does gws-docs use?

gws-docs uses `gws docs <resource> <method>` including documents.batchUpdate for edits and the +write helper to append text, with `gws docs --help` for full flag reference.

What prerequisites does gws-docs require?

gws-docs requires the gws binary installed, gws-shared auth configuration, and skill version 0.22.5; run `gws generate-skills` if the shared skill file is missing.

Is Gws Docs safe to install?

skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.