Skip to main content
Glama
Google Slides MCP
by kapilcdave

Google Slides MCP

An open-source Model Context Protocol server for Google Slides. Connect it to any MCP client — Claude, Cursor, Windsurf, ChatGPT desktop, or a local model — and the AI can create decks, add slides, write text, insert images/tables/shapes, edit speaker notes, restyle content, and export to PDF/PPTX.

  • Any model. MCP is model-agnostic; the server exposes tools, your client's model decides how to use them.

  • Any Google token. OAuth refresh token, short-lived access token, service account, or Application Default Credentials.

  • No lock-in. The AI drives the official Google Slides API directly. Your decks stay in your Google account.

Not affiliated with Google or Anthropic. Google Slides is a trademark of Google LLC.

Quick start

git clone https://github.com/kapilcdave/google-slides-mcp
cd google-slides-mcp
npm install
npm run build

1. Enable the APIs

In Google Cloud Console:

  1. Create (or pick) a project.

  2. Enable Google Slides API and Google Drive API.

  3. Configure the OAuth consent screen. Add yourself as a test user while the app is in testing.

  4. Create credentials → OAuth client ID → Desktop app.

  5. Copy the client ID and client secret.

2. Get a refresh token

GOOGLE_CLIENT_ID=your-id \
GOOGLE_CLIENT_SECRET=your-secret \
npm run auth

This opens a browser, asks for the presentations, drive.file, and drive.readonly scopes, and writes:

~/.config/google-slides-mcp/.env

The server loads that file automatically, so you do not need to repeat the credentials in every client config.

3. Connect your MCP client

Claude Code

claude mcp add google-slides -- node /absolute/path/to/google-slides-mcp/dist/index.js

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS)

{
  "mcpServers": {
    "google-slides": {
      "command": "node",
      "args": ["/absolute/path/to/google-slides-mcp/dist/index.js"]
    }
  }
}

Cursor / Windsurf / generic MCP config

{
  "mcpServers": {
    "google-slides": {
      "command": "node",
      "args": ["/absolute/path/to/google-slides-mcp/dist/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "optional-if-not-in-env-file",
        "GOOGLE_CLIENT_SECRET": "optional-if-not-in-env-file",
        "GOOGLE_REFRESH_TOKEN": "optional-if-not-in-env-file"
      }
    }
  }
}

Run without cloning (uses the GitHub repo):

{
  "mcpServers": {
    "google-slides": {
      "command": "npx",
      "args": ["-y", "github:kapilcdave/google-slides-mcp"]
    }
  }
}

Restart the client and ask: "Make me a 10-slide deck about the future of urban farming."

Related MCP server: google-slides-mcp

Authentication options

The server picks the first available option:

Credentials

Use case

GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRET + GOOGLE_REFRESH_TOKEN

Recommended. Long-lived, auto-refreshing.

GOOGLE_ACCESS_TOKEN

Bring any short-lived OAuth access token (e.g. from gcloud auth print-access-token with the right scopes). Expires in ~1 hour.

GOOGLE_SERVICE_ACCOUNT_JSON

Service account key file path or inline JSON. Share the target deck with the service account email.

GOOGLE_SERVICE_ACCOUNT_JSON + GOOGLE_IMPERSONATE_USER

Domain-wide delegation: act as a Workspace user.

GOOGLE_APPLICATION_CREDENTIALS

Application Default Credentials.

Required scopes:

https://www.googleapis.com/auth/presentations
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly

drive.readonly is only needed for exporting decks you did not create with this app. Drop it if you only need export_deck on decks created by the server.

Tools

Tool

What it does

create_presentation

Create an empty deck

create_deck_from_outline

Build a full themed deck from structured slides + bullets + notes

get_presentation

Compact summary of slides, element IDs, text, notes (or raw JSON)

list_slides

List slides, indexes, IDs, titles

get_slide

Full element detail for one slide

add_slide

Add a slide with any predefined layout, title, body, bullets, notes, theme

delete_slide

Delete a slide

duplicate_slide

Duplicate a slide

move_slide

Move one slide to an index

reorder_slides

Set the complete slide order

add_text_box

Add styled text (font, size, color, alignment, bullets)

add_bullets

Add a bullet list

update_text

Replace text in an element

replace_all_text

Deck-wide find and replace

format_text

Style a character range (bold, italic, size, color, highlight, link)

add_image

Insert a public image URL

add_shape

Insert a shape with fill, outline and text

add_table

Insert a table filled from a 2D array

set_slide_background

Set a solid background color

set_speaker_notes

Replace speaker notes

delete_element

Delete a shape/image/table

export_deck

Export to PDF or PPTX via Drive

batch_update

Raw Slides API batchUpdate escape hatch

There is also a build_deck prompt that gives the model a good outline-first workflow.

Themes

midnight, light, sunset, forest. Themes set the background, title/body colors, accent bar and font. Coordinates in tools are in inches on a 13.333 × 7.5 in widescreen slide.

Example prompts

Build a 12-slide investor update for a climate tech startup, midnight theme,
with speaker notes on every slide.

Turn this outline into a deck: ...

Add a two-column comparison slide after slide 4 and use the forest theme.

Replace every "Q3" with "Q4" and export the deck to PDF.

How it works

MCP client (Claude / Cursor / any model)
        │  stdio (JSON-RPC)
        ▼
google-slides-mcp  ──►  Google Slides API
                   └──►  Google Drive API (export only)

The server does not call an LLM. The client's model chooses tools and arguments; the server validates them with Zod and translates them into Google Slides batchUpdate requests.

Development

npm run dev        # run from source with tsx
npm run typecheck
npm run build

export_deck writes files relative to the server process's working directory unless you pass an absolute outputPath.

Security

  • Credentials are read from env vars or ~/.config/google-slides-mcp/.env (mode 600). Never commit them.

  • The server only talks to Google APIs. batch_update can do anything the Slides API allows with your token, so only connect MCP clients you trust.

  • Revoke access at myaccount.google.com/permissions.

License

MIT

Available Tools

23 tools
add_bulletsAdd bullet listA

Add a bullet list text box to a slide. Convenience wrapper around add_text_box.

Inputs: bullets (required), slideId (required), presentationId (required), color, +6 more.

add_imageAdd imageA

Insert an image from a publicly accessible URL into a slide at a given position and size (inches).

Inputs: slideId (required), imageUrl (required), presentationId (required), topInches, +3 more.

add_shapeAdd shapeA

Add a shape (RECTANGLE, ROUND_RECTANGLE, ELLIPSE, TRIANGLE, DIAMOND, STAR_5, ARROW_RIGHT, etc.) with optional fill, outline and text.

Inputs: slideId (required), shapeType (required), presentationId (required), text, +8 more.

add_slideAdd slideB

Add a slide using a Google Slides layout. Optionally fill the title, body or bullet list, apply a theme, and add speaker notes.

Inputs: presentationId (required), body, notes, theme, +4 more.

add_tableAdd tableB

Add a table to a slide, optionally filled with a 2D array of cell strings (row-major).

Inputs: rows (required), columns (required), slideId (required), presentationId (required), +5 more.

add_text_boxAdd text boxB

Add a styled text box to a slide. Coordinates are in inches. Set bulleted=true to render the lines as a bullet list.

Inputs: text (required), slideId (required), presentationId (required), bold, +11 more.

batch_updateRaw batch updateA
Destructive

Escape hatch: send raw Google Slides API batchUpdate requests. Use for advanced edits not covered by the other tools. See the Slides API request reference.

Inputs: requests (required), presentationId (required).

create_deck_from_outlineCreate deck from outlineA

Create a complete, themed Google Slides deck from a structured outline in one call. The first slide defaults to a title slide; the rest default to title + bullets. Use this for most new decks, then refine with other tools.

Inputs: title (required), slides (required), theme, subtitle, +1 more.

create_presentationCreate presentationA

Create a new, empty Google Slides presentation and return its ID and URL.

Inputs: title (required).

delete_elementDelete elementA
DestructiveIdempotent

Delete a shape, image, table or other page element. Use delete_slide to remove whole slides.

Inputs: objectId (required), presentationId (required).

delete_slideDelete slideC
DestructiveIdempotent

Delete a slide (page) from a presentation.

Inputs: slideId (required), presentationId (required).

duplicate_slideDuplicate slideC

Duplicate a slide, optionally moving the copy to an index.

Inputs: slideId (required), presentationId (required), insertionIndex.

export_deckExport deckB
Read-only

Export the presentation to PDF or PPTX with Google Drive and write it to the local filesystem.

Inputs: presentationId (required), format, outputPath.

format_textFormat textA

Style a character range inside a shape or text box. Indices are zero-based UTF-16 offsets. Use get_slide to find text first.

Inputs: endIndex (required), objectId (required), startIndex (required), presentationId (required), +9 more.

get_presentationGet presentationA
Read-only

Get a compact summary of a presentation: title, size, slides, their object IDs, element IDs, text, and speaker notes. Set raw=true for the full Google API response.

Inputs: presentationId (required), raw.

get_slideGet slideA
Read-only

Get one slide with element IDs, types, text, positions, sizes and speaker notes. Use this before editing elements.

Inputs: slideId (required), presentationId (required).

list_slidesList slidesA
Read-only

List every slide in a deck with its index, object ID, title and layout ID.

Inputs: presentationId (required).

move_slideMove slideC

Move a slide to a new zero-based index.

Inputs: slideId (required), insertionIndex (required), presentationId (required).

reorder_slidesReorder slidesA

Set the complete slide order. Pass every slide object ID exactly once, in the desired order.

Inputs: presentationId (required), orderedSlideIds (required).

replace_all_textReplace all textA

Find and replace text across the whole deck, like Find & Replace in Slides.

Inputs: findText (required), replaceText (required), presentationId (required), matchCase.

set_slide_backgroundSet slide backgroundB

Set a slide's background to a solid color.

Inputs: color (required), slideId (required), presentationId (required).

set_speaker_notesSet speaker notesB
Destructive

Replace a slide's speaker notes.

Inputs: notes (required), slideId (required), presentationId (required).

update_textUpdate textA
Destructive

Replace all text inside a shape or text box. Get the object ID from get_slide.

Inputs: text (required), objectId (required), presentationId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 23 tools

    Disambiguation4/5

    Almost every tool pairs a distinct resource with a distinct action, and descriptions disambiguate well (e.g. delete_element explicitly points to delete_slide for whole slides). A few overlaps remain: move_slide vs reorder_slides both change ordering, add_bullets is a wrapper around add_text_box, and get_presentation/list_slides/get_slide cover similar read territory at different granularities.

    Naming Consistency5/5

    All 23 tools use consistent snake_case verb_noun form (get_slide, add_table, set_speaker_notes, delete_element, export_deck). Even the compound names like create_deck_from_outline and replace_all_text follow the same predictable convention.

    Tool Count4/5

    23 tools is at the heavy end, but a Slides editor is a genuinely broad domain and most tools map to a real capability. There is some redundancy (add_bullets as a thin wrapper, move_slide alongside reorder_slides, plus a batch_update escape hatch) that could be trimmed.

    Completeness5/5

    The surface covers the full lifecycle: create/read/update/delete slides and elements, ordering, text and character-range formatting, find-and-replace, images, shapes, tables, backgrounds, speaker notes, and PDF/PPTX export. batch_update closes any remaining gaps for advanced API operations.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers