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:

Go to https://console.cloud.google.com/apis/credentials
Create OAuth client (Desktop app)
Enable Google Docs API and Google Drive API
Download JSON to ~/.claude/skills/google-docs-skill/credentials.json
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 user@example.com

# 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 user@example.com

# Share as reader
python3 ~/.claude/skills/google-docs-skill/docs_skill.py share DOC_ID --email user@example.com --role reader

# Share with multiple people
python3 ~/.claude/skills/google-docs-skill/docs_skill.py share DOC_ID --email user1@example.com user2@example.com

# 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 client@example.com

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 myemail@gmail.com

# Logout
python3 ~/.claude/skills/google-docs-skill/docs_skill.py logout --account myemail@gmail.com

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 client@example.com

# 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"