Google Docs Manager

Manage Google Docs via Service Account — no browser interaction required, fully automatable.

Prerequisites

1. Google Cloud project with Docs API + Drive API enabled
2. Service Account JSON key file
3. Set GOOGLECREDENTIALSPATH=/path/to/credentials.json
4. Install: pip install -r requirements.txt

When to Use

• User says: "create a doc", "write a document", "find doc", "read doc content", "append/insert/replace text in doc", "delete document"
• Agent needs to read or modify Google Docs content programmatically
• Not for downloading binary files or managing non-Doc files (use google-drive-manager instead)

Quick Reference

Output Format

All commands return structured JSON:

{"status": "success", "message": "...", "data": {...}}
{"status": "error",   "message": "..."}

Agent Rules

1. Always check status field before using data
2. Use find before editing — never guess doc IDs
3. Use get-text to read content before making targeted edits
4. Prefer replace-text for targeted changes; use append-text for additions
5. Default delete moves to trash — use --permanent only when explicitly requested
6. docid is the alphanumeric string in the Google Docs URL: https://docs.google.com/document/d/<docid>/edit

Chained Operation Pattern

# Find → read → edit workflow
python scripts/docs.py find "meeting notes"
# → extract doc_id from data.documents[0].id

python scripts/docs.py get-text <doc_id>
# → read current content

python scripts/docs.py replace-text <doc_id> "old section" "updated section"
# → targeted edit

Auth Management

python scripts/auth.py status      # Check credentials file
python scripts/auth.py validate    # Test API connectivity

Common Mistakes