google-slides-mcp

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

1. Go back to Credentials > + CREATE CREDENTIALS > OAuth client ID
2. Application type: Desktop app
3. Name it (e.g., Slides MCP Desktop)
4. Click Create
5. 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: ``json "args": ["/Users/username/google-slides-mcp/dist/index.js"] ``

Windows example: ``json "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