gws-docs
Lets your agent read and write in Google Docs documents. It's useful for creating, editing, and reviewing texts.
What it does
This tool lets you read and write to your Google Docs. You can create new documents, view the content of an existing document, or add text to it.
When to use it
- ✓Quickly create a new document.
- ✓Check the content of a document without opening it.
- ✓Add information to an existing document.
Example of what to ask your AI
“Create a new document named 'My To-Do List' and add 'Buy milk' to it.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You tell the tool which document you want to access and what to do with it (read, write, or create). It connects to Google Docs to perform the requested action.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-docsOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-docs/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
docs (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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.
FAQ
How does the tool know which document I want?
You need to provide the document's name or an identifier when you make the request.
Can I edit an entire document?
Currently, the tool is more focused on adding text. For complete edits, you might need to use other options.
Do I need a Google account?
Yes, to access and modify your Google Docs, you need to be logged into your Google account.
Details
Popularity
- GitHub stars
- 32k
- Ranking position
- #6258
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
intent-driven-development
Helps your agent turn ideas into clear, testable plans. Defines criteria to ensure changes are made correctly and safely.
affaan-m/ECC
product-capability
Guides your agent in turning product ideas into clear plans. It defines what needs to be done, the limits, and decisions before development.
affaan-m/ECC
article-writing
Writes long-form content like articles, guides, and blog posts with a unique style. It's useful when you need well-written texts with a consistent voice and credibility.
affaan-m/ECC