docs (v1)
SkillDev toolsgws-docs is a skill that lets an AI agent read and write Google Docs. It gives the agent a way to open a document, pull its text, and make edits on your behalf. You can use it when a task depends on content that lives in a Google Doc instead of a local file.
Use docs (v1) in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add docs (v1) and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the docs (v1) skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Have a Google account with access to the Docs you want the agent to use.
What your AI can do with it
- Read the text content of a Google Doc
- Write or edit content in a Google Doc
- Work with Google Docs from an agent task
Getting started
- Have a Google account with access to the Docs you want the agent to use.
- Add the gws-docs skill to your agent setup.
- Configure the credentials or access the skill needs for Google Docs.
- Point the agent at a document and ask it to read or edit.
What this skill tells your AI
The instructions your AI receives, as published by googleworkspace/cli in skills/gws-docs/SKILL.md and read by Ahel’s review.
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.
Signals
- GitHub stars
- 31k
- Forks
- 2k
- Last commit
- Sep 2026
- Installs
- 56k installs
Questions
- What does gws-docs do?
- It lets an AI agent read and write Google Docs, so the agent can pull text from a document or make edits to it.
- Can it read and write Google Docs?
- Yes. The skill covers both reading and writing Google Docs.
- Do I need a Google account to use it?
- You need access to the Google Docs the agent will work with, which normally means a Google account with permission to those documents.
- Does it work with documents other than Google Docs?
- The skill is for Google Docs. It does not cover other document types.
Advanced
- Item type
- skill
- Key
gws-docs- Source
- github.com/googleworkspace/cli
github.com/googleworkspace/cli