google-docs-skill

name	google-docs-skill
description	Create, read, update, share, and export Google Docs. Use when the user asks to create documents, write content to Google Docs, share docs, export to PDF/DOCX, or convert markdown files to Google Docs.
allowed-tools	Bash, Read

Google Docs Skill

Create, read, update, share, and export Google Docs with markdown formatting support.

Setup

Uses same Google OAuth as gmail-skill. If configured, this works automatically.

Otherwise:

1. Go to https://console.cloud.google.com/apis/credentials
2. Create OAuth client (Desktop app)
3. Enable Google Docs API and Google Drive API
4. Download JSON to ~/.claude/skills/google-docs-skill/credentials.json
5. Run: python3 ~/.claude/skills/google-docs-skill/docs_skill.py login

Commands

List Documents

python3 ~/.claude/skills/google-docs-skill/docs_skill.py list [--limit N] [--account EMAIL]

Create Document

# Empty document
python3 ~/.claude/skills/google-docs-skill/docs_skill.py create --title "My Document"

# With markdown body
python3 ~/.claude/skills/google-docs-skill/docs_skill.py create --title "My Document" --body "# Heading\n\nSome **bold** text"

# From file
python3 ~/.claude/skills/google-docs-skill/docs_skill.py create --title "My Document" --file ~/path/to/content.md

# Create and share immediately
python3 ~/.claude/skills/google-docs-skill/docs_skill.py create --title "My Document" --body "Content" --share [e-mail]

# Plain text content (backward compat)
python3 ~/.claude/skills/google-docs-skill/docs_skill.py create --title "My Document" --content "Plain text"

Read Document Content

python3 ~/.claude/skills/google-docs-skill/docs_skill.py read DOC_ID [--account EMAIL]

Returns plain text content of the document.

Get Document Info

python3 ~/.claude/skills/google-docs-skill/docs_skill.py get DOC_ID [--account EMAIL]

Update Document (Replace All Content)

# Replace content with markdown body
python3 ~/.claude/skills/google-docs-skill/docs_skill.py update DOC_ID --body "# New Content\n\nReplaces everything"

# Replace content from file
python3 ~/.claude/skills/google-docs-skill/docs_skill.py update DOC_ID --file ~/path/to/new-content.md

Append Text

python3 ~/.claude/skills/google-docs-skill/docs_skill.py append DOC_ID --text "New content at the end"

Insert Text at Position

python3 ~/.claude/skills/google-docs-skill/docs_skill.py insert DOC_ID --text "Inserted text" --index 1

Note: Google Docs uses 1-based indexing. Index 1 is the start of the document.

Find and Replace

python3 ~/.claude/skills/google-docs-skill/docs_skill.py replace DOC_ID --find "old text" --replace "new text"

Share Document

# Share as writer (default)
python3 ~/.claude/skills/google-docs-skill/docs_skill.py share DOC_ID --email [e-mail]

# Share as reader
python3 ~/.claude/skills/google-docs-skill/docs_skill.py share DOC_ID --email [e-mail] --role reader

# Share with multiple people
python3 ~/.claude/skills/google-docs-skill/docs_skill.py share DOC_ID --email [e-mail] [e-mail]

# Roles: reader, writer, commenter

Export Document

# Export to PDF
python3 ~/.claude/skills/google-docs-skill/docs_skill.py export DOC_ID --format pdf

# Export to DOCX with custom path
python3 ~/.claude/skills/google-docs-skill/docs_skill.py export DOC_ID --format docx --output ~/Downloads/contract.docx

# Export to plain text
python3 ~/.claude/skills/google-docs-skill/docs_skill.py export DOC_ID --format txt

Supported formats: pdf, docx, txt, html, md, odt, rtf

Create from Markdown File

# Convert markdown file to Google Doc
python3 ~/.claude/skills/google-docs-skill/docs_skill.py from-markdown ~/Documents/contract.md --title "Contract"

# Create from markdown and share
python3 ~/.claude/skills/google-docs-skill/docs_skill.py from-markdown ~/Documents/proposal.md --title "Proposal" --share [e-mail]

Account Management

# List accounts
python3 ~/.claude/skills/google-docs-skill/docs_skill.py accounts

# Login
python3 ~/.claude/skills/google-docs-skill/docs_skill.py login --account [e-mail]

# Logout
python3 ~/.claude/skills/google-docs-skill/docs_skill.py logout --account [e-mail]

Upload Image to Drive

Upload an image to Google Drive and get a public URL for embedding in other services (Gamma, etc.):

python3 ~/.claude/skills/google-docs-skill/docs_skill.py upload-image /path/to/image.png [--folder-id FOLDER_ID]

Returns a direct lh3.googleusercontent.com URL that serves the image without redirects — works for embedding in Gamma presentations, web pages, etc.

Integration with Gamma Skill: To use custom images in Gamma presentations, upload them via this command, then embed the directUrl in your Gamma inputText with --image-source noImages. The drive.google.com/uc URLs do NOT work (303 redirect) — only the lh3.googleusercontent.com/d/{id} format serves direct.

Markdown Formatting Support

The create, update, and from-markdown commands convert markdown to native Google Docs formatting:

Markdown	Google Docs
# Heading	Heading 1
## Heading	Heading 2
### Heading	Heading 3
#### Heading	Heading 4
**bold**	Bold text
*italic*	Italic text
***bold italic***	Bold + Italic
- item	Bullet list
1. item	Numbered list
---	Paragraph break

Document ID

Found in the URL: https://docs.google.com/document/d/DOCUMENT_ID/edit

Output

All commands output JSON.

Examples

Create a contract from markdown, share, and export

# Create from file and share
python3 docs_skill.py from-markdown ~/vault/Epoch/Contracts/Agreement.md --title "Service Agreement" --share [e-mail]

# Export as PDF for attachment
python3 docs_skill.py export DOC_ID --format pdf --output ~/Downloads/agreement.pdf

Bulk find/replace for templates

python3 docs_skill.py replace DOC_ID --find "[CLIENT_NAME]" --replace "Epoch ML, Inc."
python3 docs_skill.py replace DOC_ID --find "[DATE]" --replace "February 20, 2026"
python3 docs_skill.py replace DOC_ID --find "[AMOUNT]" --replace "$50,000"

Update existing doc with new content

python3 docs_skill.py update DOC_ID --body "# Updated Report\n\nNew content with **formatting**.\n\n- Item one\n- Item two"