Skip to content
MCP server

Google Slides MCP

Read Google Slides decks and speaker notes, add slides and replace text

Runs locallyStatus and history
Pricing
Open source
Platforms
vscode, CLI, self-hosted
Runs
Locally
Version
26.11.14
Listing updated
2 days ago

About Google Slides MCP

Google Slides MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.
  • GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.
  • GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.
  • GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Google Slides scopes.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free, MIT-licensed

Prices change. Check renzojohnson.com before you buy.

Google Slides MCP 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 to Google Slides MCP

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents