Google Slides MCP
Provides export of Google Slides decks to PDF or PPTX through the Google Drive API, enabling presentations to be downloaded or shared from Google Drive.
Provides tools for creating and managing Google Slides presentations via the Google Slides API, including building decks from outlines, adding/deleting/duplicating/moving slides, inserting text, bullets, images, tables, and shapes, formatting text, setting backgrounds and speaker notes, replacing text deck-wide, and performing raw batch updates.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Slides MCP make me a 10-slide deck about the future of urban farming"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 build1. Enable the APIs
Create (or pick) a project.
Enable Google Slides API and Google Drive API.
Configure the OAuth consent screen. Add yourself as a test user while the app is in testing.
Create credentials → OAuth client ID → Desktop app.
Copy the client ID and client secret.
2. Get a refresh token
GOOGLE_CLIENT_ID=your-id \
GOOGLE_CLIENT_SECRET=your-secret \
npm run authThis opens a browser, asks for the presentations, drive.file, and drive.readonly scopes, and writes:
~/.config/google-slides-mcp/.envThe 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.jsClaude 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 |
| Recommended. Long-lived, auto-refreshing. |
| Bring any short-lived OAuth access token (e.g. from |
| Service account key file path or inline JSON. Share the target deck with the service account email. |
| Domain-wide delegation: act as a Workspace user. |
| Application Default Credentials. |
Required scopes:
https://www.googleapis.com/auth/presentations
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonlydrive.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 an empty deck |
| Build a full themed deck from structured slides + bullets + notes |
| Compact summary of slides, element IDs, text, notes (or raw JSON) |
| List slides, indexes, IDs, titles |
| Full element detail for one slide |
| Add a slide with any predefined layout, title, body, bullets, notes, theme |
| Delete a slide |
| Duplicate a slide |
| Move one slide to an index |
| Set the complete slide order |
| Add styled text (font, size, color, alignment, bullets) |
| Add a bullet list |
| Replace text in an element |
| Deck-wide find and replace |
| Style a character range (bold, italic, size, color, highlight, link) |
| Insert a public image URL |
| Insert a shape with fill, outline and text |
| Insert a table filled from a 2D array |
| Set a solid background color |
| Replace speaker notes |
| Delete a shape/image/table |
| Export to PDF or PPTX via Drive |
| Raw Slides API |
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 buildexport_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(mode600). Never commit them.The server only talks to Google APIs.
batch_updatecan 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 toolsadd_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 updateADestructive
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 elementADestructiveIdempotent
Delete a shape, image, table or other page element. Use delete_slide to remove whole slides.
Inputs: objectId (required), presentationId (required).
delete_slideDelete slideCDestructiveIdempotent
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 deckBRead-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 presentationARead-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 slideARead-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 slidesARead-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 notesBDestructive
Replace a slide's speaker notes.
Inputs: notes (required), slideId (required), presentationId (required).
update_textUpdate textADestructive
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
Scored across 23 tools
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.
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.
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.
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
Related MCP Connectors
Create, edit, export and manage presentations. Requires a paid PPT.AI API merchant account.
Generate AI slide decks and export native PowerPoint (.pptx) and PDF presentations from chat.
Generate, edit, and export AI presentations to PDF, PPTX, or a shareable link.
Create designed slide decks from a prompt, notes, or an outline, then export them or share a link.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to control Google Workspace services (Slides, Sheets, Drive) through natural language.144 npmISC
- AlicenseAqualityCmaintenanceEnables low-level interaction with Google Slides API, including template reuse, element bounding box editing, slide rendering, and batch updates for automated slide deck creation.23MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to build and edit Google Slides presentations through natural language, including managing slides, text, shapes, images, tables, speaker notes, comments, thumbnails, and exporting to PDF or PPTX.32412 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to create and edit presentation decks—manipulating documents, slides, shapes, text, animations, transitions, and exports—while reading tabular data and generating 18 types of business charts.1MIT