Google Slides MCP Server

An MCP (Model Context Protocol) server for Google Slides. Enables AI assistants (Claude Code, Cursor, Windsurf, etc.) to create, read, and edit Google Slides presentations directly from chat.

Features

39 tools organized into 4 categories:

Presentations (4)

Tool	Description
createPresentation	Create a new presentation
getPresentation	Get metadata and slide summaries
listPresentations	Search presentations on Drive
duplicatePresentation	Copy an entire presentation (template workflow)

Slides (10)

Tool	Description
addSlide	Add a slide with layout (BLANK, TITLE, TITLE_AND_BODY, ...)
deleteSlide	Delete slide(s)
duplicateSlide	Duplicate a slide
reorderSlides	Reorder slides
getSlide	Get detailed element info for a slide
updateSlideBackground	Set background color or image
setSpeakerNotes / getSpeakerNotes	Manage speaker notes
copySlideFromPresentation	Import a slide from another presentation
setSkipSlide	Show/hide slide in slideshow

Elements (25)

Group	Tools
Insert	insertTextBox, insertImage, insertShape, insertTable, insertVideo, insertLine
Table	insertTableRow, insertTableColumn, deleteTableRow, deleteTableColumn, updateTableCell, formatTableCell, mergeTableCells, unmergeTableCells
Edit	updateText, updateTextStyle, updateShapeStyle, setParagraphStyle, moveResizeElement
Other	deleteElement, groupElements, ungroupElements, replaceAllText, replaceImage, batchUpdate

Export (2)

Tool	Description
exportPresentation	Export to PDF, PPTX, or ODP
getThumbnail	Get thumbnail image of a slide

---

Setup Guide

Step 1: Create a Google Cloud Project

1. Go to Google Cloud Console
2. Click Select a project > New Project
3. Name your project (e.g., google-slides-mcp) > Create

Step 2: Enable APIs

1. Navigate to APIs & Services > Library
2. Search and Enable these 2 APIs:
   • Google Slides API
   • Google Drive API

Step 3: Create OAuth Credentials

1. Go to APIs & Services > Credentials
2. Click + CREATE CREDENTIALS > OAuth client ID
3. If you haven't configured the consent screen yet:
   • Click Configure Consent Screen
   • Select External > Create
   • Fill in App name (e.g., Slides MCP)
   • Add User support email and Developer contact email
   • Click Save and Continue through all steps > Back to Dashboard
4. Go back to Credentials > + CREATE CREDENTIALS > OAuth client ID
5. Application type: Desktop app
6. Name it (e.g., Slides MCP Desktop)
7. Click Create
8. Click Download JSON > save as credentials.json

Step 4: Install

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

Step 5: Authorize

Copy your credentials.json (downloaded in Step 3) into the project folder:

cp /path/to/credentials.json .

Run the auth flow:

node dist/index.js auth

A URL will appear in the terminal. Open it in your browser, sign in with your Google account, and grant access. Your token will be saved at ~/.config/google-slides-mcp/token.json.

Note: If you see "This app isn't verified", click Advanced > Go to Slides MCP (unsafe). This is normal for unverified apps.

Step 6: Configure with Claude Code

Open ~/.claude.json and add to the mcpServers section:

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

Replace /full/path/to/ with the actual path on your machine.

macOS example:

"args": ["/Users/username/google-slides-mcp/dist/index.js"]

Windows example:

"args": ["C:\\Users\\username\\google-slides-mcp\\dist\\index.js"]

Then restart Claude Code to load the MCP server.

Step 7: Test

Open Claude Code and try:

Create a new presentation called "Hello World"

If Claude creates the presentation and returns a Google Slides link, you're all set!

---

Other MCP Clients

Cursor / Windsurf

Add to .cursor/mcp.json or .windsurf/mcp.json:

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

Claude Desktop

Add to claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

---

Environment Variables (optional)

Variable	Description
GOOGLE_CLIENT_ID	OAuth client ID (alternative to credentials.json)
GOOGLE_CLIENT_SECRET	OAuth client secret
SERVICE_ACCOUNT_PATH	Path to service account key file
GOOGLE_IMPERSONATE_USER	Email to impersonate (service account only)
GOOGLE_MCP_PROFILE	Profile name (supports multiple Google accounts)
LOG_LEVEL	debug, info, warn, error, silent (default: info)

Security

• OAuth state parameter for CSRF protection
• Token file stored with permission 0600 (owner-only read)
• Client secret not persisted in token file
• Profile name sanitization (prevents path traversal)
• Minimal OAuth scopes: presentations + drive.file

Tech Stack

• TypeScript + Node.js (ES2022)
• FastMCP — MCP server framework
• googleapis — Google APIs client
• zod — Schema validation

Troubleshooting

"No OAuth credentials found"

Copy credentials.json into the project root. See Step 3 and 5.

"Token might expire"

Run node dist/index.js auth again to re-authorize.

"Google Slides client is not initialized"

Check that credentials.json is valid and Google Slides API is enabled (Step 2).

Claude Code doesn't show the tools

Verify the path in ~/.claude.json is correct. Restart Claude Code after updating the config.

License

ISC