
Gws Docs Write
- 39.5k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
gws-docs-write is a CLI skill that appends text to Google Docs documents using the Google Workspace API.
About
CLI skill for appending text to Google Docs documents. Provides command-line interface to Google Workspace APIs with simple flag-based syntax for document management. Useful for developers automating document workflows and integrations.
- Append text to documents via simple CLI flags
- Google Workspace API integration
- Document ID and text content handling
Gws Docs Write by the numbers
- 39,474 all-time installs (skills.sh)
- +1,366 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #21 of 690 Office & Documents skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
gws-docs-write capabilities & compatibility
- Works with
- google drive
What gws-docs-write says it does
Google Docs: Append text to a document.
Text is inserted at the end of the document body.
npx skills add https://github.com/googleworkspace/cli --skill gws-docs-writeAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 39.5k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
How do you append text to Google Docs from CLI?
Developers building automation workflows need programmatic access to Google Docs via CLI for document management and text operations.
Who is it for?
Automation engineers building document workflows
Skip if: Rich formatted Docs editing, bulk document creation, or teams not authenticated through gws-shared OAuth flows.
When should I use this skill?
Appending content to Google Docs, automating document workflows
What you get
Appended Google Doc content updated via gws docs +write with document ID and plain-text payload.
- Appended Google Doc text
- Terminal command invocation log
By the numbers
- Skill metadata version 0.22.5
- Command requires 2 flags: --document and --text
Files
docs +write
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Append text to a document
Usage
gws docs +write --document <ID> --text <TEXT>Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--document | ✓ | — | Document ID |
--text | ✓ | — | Text to append (plain text) |
Examples
gws docs +write --document DOC_ID --text 'Hello, world!'Tips
- Text is inserted at the end of the document body.
- For rich formatting, use the raw batchUpdate API instead.
[!CAUTION]
This is a write command — confirm with the user before executing.
See Also
- gws-shared — Global flags and auth
- gws-docs — All read and write google docs commands
Related skills
How it compares
Pick this over hand-rolled Google Docs API clients when gws is installed and the task is append-only plain text.
FAQ
What command does gws-docs-write use to append text?
gws-docs-write documents gws docs +write --document <ID> --text <TEXT>, requiring both flags to append plain text to an existing Google Doc from the terminal using the gws CLI.
What must be installed before gws-docs-write runs?
gws-docs-write requires the gws binary and gws-shared SKILL.md for auth, global flags, and security rules. If shared skills are missing, run gws generate-skills first per the skill prerequisite.
Is Gws Docs Write safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.