| name | google-docs |
| description | Read, write, and manage Google Docs. Load when user mentions 'google docs', 'google document', 'create doc', 'read doc', 'write doc', 'edit document', or references creating/editing text documents in Google Drive. |
Google Docs
Read, write, create, and manage Google Docs via OAuth authentication.
Pre-Flight Check (ALWAYS RUN FIRST)
python3 00-system/skills/google/google-master/scripts/google_auth.py --check --service docs
Exit codes:
- 0: Ready to use - proceed with user request
- 1: Need to login - run
python3 00-system/skills/google/google-master/scripts/google_auth.py --login
- 2: Missing credentials or dependencies - see ../google-master/references/setup-guide.md
Quick Reference
Read Document
python3 00-system/skills/google/google-docs/scripts/docs_operations.py read <document_id>
Create Document
python3 00-system/skills/google/google-docs/scripts/docs_operations.py create "My Document" --content "Initial content here"
Insert Text
python3 00-system/skills/google/google-docs/scripts/docs_operations.py insert <document_id> "Text to insert" --index 1
Append Text
python3 00-system/skills/google/google-docs/scripts/docs_operations.py append <document_id> "Text to append at end"
Find and Replace
python3 00-system/skills/google/google-docs/scripts/docs_operations.py replace <document_id> "old text" "new text"
Export Document
python3 00-system/skills/google/google-docs/scripts/docs_operations.py export <document_id> --format pdf --output ./report.pdf
List Documents
python3 00-system/skills/google/google-docs/scripts/docs_operations.py list --query "report"
Copy Document
python3 00-system/skills/google/google-docs/scripts/docs_operations.py copy <document_id> "Copy of My Document"
Rename Document
python3 00-system/skills/google/google-docs/scripts/docs_operations.py rename <document_id> "New Title"
Document ID
The document ID is in the URL:
https://docs.google.com/document/d/[DOCUMENT_ID]/edit
Common Workflows
Generate Report -> Save to Google Docs
from docs_operations import create_document, append_text
doc = create_document("Weekly Report - Jan 2024")
append_text(doc['document_id'], "Key findings from this week...")
print(f"Report created: {doc['url']}")
Create Document from Template
from docs_operations import copy_document, replace_all_text
new_doc = copy_document(template_id, "Invoice #1234")
replace_all_text(new_doc['document_id'], "{{CLIENT}}", "Acme Corp")
replace_all_text(new_doc['document_id'], "{{AMOUNT}}", "$5,000")
Available Operations
| Operation | Function | Description |
|---|
| Read | read_document() | Get document content |
| Info | get_document_info() | Get title, ID, URL |
| Create | create_document() | Create new document |
| Copy | copy_document() | Duplicate document |
| Rename | rename_document() | Change title |
| Insert | insert_text() | Insert at position |
| Append | append_text() | Add to end |
| Replace | replace_all_text() | Find and replace |
| Export | export_document() | Export to text/HTML/PDF/DOCX |
| List | list_documents() | List accessible docs |
Error Handling
See ../google-master/references/error-handling.md for common errors and solutions.
Setup
First-time setup: ../google-master/references/setup-guide.md
Quick start:
pip install google-auth google-auth-oauthlib google-api-python-client- Create OAuth credentials in Google Cloud Console (enable Google Docs API & Drive API, choose "Desktop app")
- Add to
.env file at Nexus root:
GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_PROJECT_ID=your-project-id
- Run
python3 00-system/skills/google/google-master/scripts/google_auth.py --login
