# Google Slides > Google Slides API for reading and editing presentations and speaker notes. Use when user mentions "Google Slides", "slides", "presentation", "speaker notes", or shares a docs.google.com/presentation link. - Skill: `vm0-ai/google-slides` (Agent Skill) - Install (CLI): `npx skillmds@latest add vm0-ai/google-slides` - Raw SKILL.md: https://api.skillmd.com/api/skills/vm0-ai/google-slides/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: vm0-ai (https://skillmd.com/u/vm0-ai) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/vm0-ai/google-slides --- # Google Slides Read and edit Google Slides presentations through the Google Drive connector. > Official docs: `https://developers.google.com/workspace/slides/api/reference/rest` --- ## When to Use Use this skill when you need to: - Read presentation structure, slide content, or speaker notes - Create presentations or slides - Insert, replace, delete, or format presentation text - Update speaker notes without changing slide content or design - Generate slide thumbnails --- ## Prerequisites Connect the **Google Drive** connector at [app.okou.ai/connectors](https://app.okou.ai/connectors). > **Troubleshooting:** If requests fail, run `okou doctor check-connector --env-name GOOGLE_DRIVE_TOKEN` or `okou doctor check-connector --url https://slides.googleapis.com/v1/presentations/ --method GET` The Slides API reuses `$GOOGLE_DRIVE_TOKEN`. Reading presentations is allowed by default. Creating or modifying presentations requires the `presentations.create` or `presentations.write` Google Drive connector permission. --- ## How to Use Base URL: `https://slides.googleapis.com/v1` The presentation ID is in the URL: ```text https://docs.google.com/presentation/d//edit ``` ### 1. Read a Presentation Read the presentation structure, slides, page elements, and notes pages: ```bash curl -s "https://slides.googleapis.com/v1/presentations/" --header "Authorization: Bearer $GOOGLE_DRIVE_TOKEN" | jq '{presentationId, title, revisionId, slides}' ``` ### 2. List Speaker Notes Read every slide's speaker notes object ID and current text: ```bash curl -s "https://slides.googleapis.com/v1/presentations/" --header "Authorization: Bearer $GOOGLE_DRIVE_TOKEN" | jq '[.slides[] | .slideProperties.notesPage as $notes | {slideObjectId: .objectId, speakerNotesObjectId: $notes.notesProperties.speakerNotesObjectId, text: ([$notes.pageElements[]? | select(.objectId == $notes.notesProperties.speakerNotesObjectId) | .shape.text.textElements[]?.textRun.content] | join(""))}]' ``` Always read the presentation immediately before editing. Object IDs can change when a presentation is edited in the Google Slides UI. ### 3. Replace Existing Speaker Notes Use the `speakerNotesObjectId` returned by the previous request. Write to `/tmp/google_slides_request.json`: ```json { "requests": [ { "deleteText": { "objectId": "", "textRange": { "type": "ALL" } } }, { "insertText": { "objectId": "", "insertionIndex": 0, "text": "Updated speaker notes" } } ], "writeControl": { "requiredRevisionId": "" } } ``` Then run: ```bash curl -s -X POST "https://slides.googleapis.com/v1/presentations/:batchUpdate" --header "Authorization: Bearer $GOOGLE_DRIVE_TOKEN" --header "Content-Type: application/json" -d @/tmp/google_slides_request.json | jq '{presentationId, writeControl}' ``` When updating multiple slides, include each slide's `deleteText` and `insertText` requests in the same `requests` array. A batch update is atomic: if one request is invalid, none of the changes are applied. ### 4. Add Speaker Notes to an Empty Notes Shape If the speaker notes shape has no text, omit `deleteText`. Write to `/tmp/google_slides_request.json`: ```json { "requests": [ { "insertText": { "objectId": "", "insertionIndex": 0, "text": "New speaker notes" } } ], "writeControl": { "requiredRevisionId": "" } } ``` Then run: ```bash curl -s -X POST "https://slides.googleapis.com/v1/presentations/:batchUpdate" --header "Authorization: Bearer $GOOGLE_DRIVE_TOKEN" --header "Content-Type: application/json" -d @/tmp/google_slides_request.json | jq '{presentationId, writeControl}' ``` The Slides API creates the speaker notes shape automatically when it receives a valid text operation using a `speakerNotesObjectId` that does not yet have a shape. ### 5. Create a Presentation Write to `/tmp/google_slides_request.json`: ```json { "title": "Quarterly Review" } ``` Then run: ```bash curl -s -X POST "https://slides.googleapis.com/v1/presentations" --header "Authorization: Bearer $GOOGLE_DRIVE_TOKEN" --header "Content-Type: application/json" -d @/tmp/google_slides_request.json | jq '{presentationId, title, url: ("https://docs.google.com/presentation/d/" + .presentationId + "/edit")}' ``` ### 6. Replace Text Throughout a Presentation Write to `/tmp/google_slides_request.json`: ```json { "requests": [ { "replaceAllText": { "containsText": { "text": "Old text", "matchCase": true }, "replaceText": "New text" } } ], "writeControl": { "requiredRevisionId": "" } } ``` Then run: ```bash curl -s -X POST "https://slides.googleapis.com/v1/presentations/:batchUpdate" --header "Authorization: Bearer $GOOGLE_DRIVE_TOKEN" --header "Content-Type: application/json" -d @/tmp/google_slides_request.json | jq '.replies[0].replaceAllText' ``` ### 7. Create a Slide Write to `/tmp/google_slides_request.json`: ```json { "requests": [ { "createSlide": { "insertionIndex": 1, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_BODY" } } } ], "writeControl": { "requiredRevisionId": "" } } ``` Then run: ```bash curl -s -X POST "https://slides.googleapis.com/v1/presentations/:batchUpdate" --header "Authorization: Bearer $GOOGLE_DRIVE_TOKEN" --header "Content-Type: application/json" -d @/tmp/google_slides_request.json | jq '.replies[0].createSlide.objectId' ``` ### 8. Get a Slide Thumbnail ```bash curl -s "https://slides.googleapis.com/v1/presentations//pages//thumbnail" --header "Authorization: Bearer $GOOGLE_DRIVE_TOKEN" | jq '{contentUrl, width, height}' ``` --- ## Guidelines 1. Read the latest presentation and revision ID immediately before writing. 2. Use `writeControl.requiredRevisionId` to avoid overwriting concurrent edits. 3. Batch related changes so dependent requests succeed or fail together. 4. Only the text inside the speaker notes shape is editable; other notes-page properties are read-only. 5. Preserve slide content and design when the request only concerns speaker notes. 6. Request `presentations.write` only when a mutation is required.