# Google Slides MCP

> Google Slides MCP is an open-source MCP server for productivity. Read Google Slides decks and speaker notes, add slides and replace text. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** vscode, CLI, self-hosted
- **Website:** https://renzojohnson.com/contributions/google-slides-mcp
- **MCP Registry name:** com.renzojohnson/google-slides-mcp
- **Categories:** productivity, files and documents
- **Listing updated:** 2026-11-14

## About

Three read tools cover a whole deck (title, page size, each slide's text and optional speaker notes), a single slide element by element with type, size and position, and a temporary PNG thumbnail for one slide. A slides_admin tool creates presentations, adds slides, inserts text into shapes, replaces text across the whole deck and deletes slides, with delete gated behind confirm: true.

Typical jobs described are turning a deck into a written brief, treating a presentation as a spec, and checking a deck before a meeting for slides missing notes or stale numbers.

There are boundaries: text in images and charts is not read, thumbnail links expire, PowerPoint files in Drive must be converted first, and it needs the presentation's address or ID since it cannot find a deck by name. It runs on your own machine with your Google sign-in, and the author notes it is independent of Google's Slides MCP server.

## Features

- **Deck reading:** Returns every slide's text and speaker notes.
- **Element inspection:** Shows each element's type, size, position and text.
- **Thumbnails:** Gets a temporary PNG address for a slide.
- **Slide creation:** Adds slides with a layout and position.
- **Deck-wide replace:** Finds and replaces text across all slides.
- **Confirmed deletion:** Slide deletion needs confirm: true.

## Good for

- Summarise a deck in five points
- List slides missing speaker notes
- Replace last quarter's number across a deck
- Turn a kickoff deck into a README
- Create a deck skeleton called Q4 review

## Install

### Claude Code (Terminal)

```sh
claude mcp add google-slides-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-slides-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "google-slides-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-slides-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "google-slides-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-slides-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "google-slides-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-slides-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "google-slides-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-slides-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "google-slides-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-slides-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

## Tools

- `slides_get_presentation`: Read a deck with every slide's text and speaker notes.
- `slides_get_slide`: Read one slide element by element.
- `slides_get_thumbnail`: Get a temporary PNG thumbnail address for a slide.
- `slides_admin`: Create presentations, add slides, insert and replace text and delete slides.

## FAQ

### Can it read text inside images?

No, only text boxes, shapes and tables.

### Can it find a deck by name?

No, it needs the presentation address or ID.

### Does it handle PowerPoint files?

They must be converted to Google Slides first.

### Are thumbnail links permanent?

No, they are temporary.

### Is Google Slides MCP free?

Yes. Google Slides MCP is open source, so you can use and self-host it for free.

### How do I add Google Slides MCP to Claude Code?

Run this command in your terminal: claude mcp add google-slides-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-slides-mcp

### What are the best alternatives to Google Slides MCP?

The closest alternatives to Google Slides MCP are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/google-slides-mcp
