HML Google Slides

Create, edit, and export Google Slides presentations. Use when creating new presentations, adding or updating slides, reading slide content, exporting to PDF...

Google Slides

Uses the gog CLI for basic operations and scripts/slides.py for advanced edits (adding/editing slide content via the Slides API).

Auth Check

Before any Slides operation, verify auth is working:

gog slides info <any-presentation-id> --account [e-mail]

If it fails, re-auth: gog auth add [e-mail] --services gmail,calendar,drive,docs,sheets,contacts,tasks,people

Core Commands (via gog)

# Create a new blank presentation
gog slides create "My Presentation" --account [e-mail] --json

# Get info about a presentation (slide count, title, etc.)
gog slides info <presentationId> --account [e-mail] --json

# Export to PDF
gog slides export <presentationId> --format pdf --out /tmp/deck.pdf --account [e-mail]

# Export to PPTX
gog slides export <presentationId> --format pptx --out /tmp/deck.pptx --account [e-mail]

# Copy a presentation (e.g., to use a template)
gog slides copy <presentationId> "Copy Title" --account [e-mail] --json

Adding/Editing Slide Content (via scripts/slides.py)

For adding text slides, batch updates, and reading full content, use scripts/slides.py.

# Add a text slide with title and bullet body
python3 scripts/slides.py add-slide <presentationId> \
  --title "Slide Title" \
  --body "• Bullet point one\n• Bullet point two"

# Add a slide at a specific position (0-indexed)
python3 scripts/slides.py add-slide <presentationId> --title "Intro" --insert-at 0

# Run arbitrary batch update requests from a JSON file
python3 scripts/slides.py batch <presentationId> requests.json

# Export via script
python3 scripts/slides.py export <presentationId> --format pdf --out /tmp/deck.pdf

# List comments with their anchors (e.g. which slide they are on)
python3 scripts/slides.py list-comments <presentationId>

# Resolve a comment and optionally leave a reply message
python3 scripts/slides.py resolve-comment <presentationId> <commentId> --reply "Fixed!"

Building a Deck from Scratch

Typical workflow:

1. Create presentation: gog slides create "Title" --json → get presentationId
2. Add slides one by one using scripts/slides.py add-slide
3. For rich content (images, shapes, formatting), write batch requests to a JSON file and run scripts/slides.py batch
4. Export: gog slides export <id> --format pdf --out /tmp/deck.pdf

For complex batch requests (images, shapes, text formatting), see references/batch_requests.md.

Getting Presentation ID

From a Google Slides URL: https://docs.google.com/presentation/d/**<presentationId>**/edit

Notes

• gog slides uses the Drive API under the hood (no separate Slides scope needed)
• scripts/slides.py uses the Google Slides API directly and requires working gog auth tokens
• Set GOG_ACCOUNT=[e-mail] in env to skip --account flag