Skip to content
Back to search

google-slides-mcp

MCP Server for Google Slides

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/matteoantoci--google-slides-mcp/badge.svg)](/listings/matteoantoci--google-slides-mcp)

HTML

<a href="/listings/matteoantoci--google-slides-mcp"><img src="/api/listings/matteoantoci--google-slides-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Google Slides MCP Server
  2. This process is an MCP server for the Google Slides API. A host talks to it on stdio. The first start opens a browser. You paste a Desktop client id and client secret. Google consent follows. Later starts read the token store.
  3. ## Prerequisites
  4. - Node.js 20 or later
  5. - A Google Cloud project with the Google Slides API enabled
  6. - An OAuth Desktop client id and client secret
  7. You do not need a refresh token. You do not need process env.
  8. ## Claude Code
  9. 1. Create a Desktop OAuth client. Use the Google Auth platform steps below.
  10. 2. In Claude Code run:
  11. ```
  12. /plugin marketplace add matteoantoci/claude-plugins
  13. /plugin install google-slides-mcp@matteoantoci-plugins
  14. ```
  15. 3. Run `/reload-plugins` if Claude asks.
  16. 4. The first start opens a browser. Paste the client id and the client secret. Finish Google consent.
  17. Later sessions read the token store. No host JSON. No env.
  18. ## Other hosts
  19. 1. Clone this repository.
  20. 2. Run `npm install`.
  21. 3. Run `npm run build`.
  22. 4. Create a Desktop OAuth client in [Google Cloud Console](https://console.cloud.google.com/):
  23. - Open [Google Auth platform](https://console.cloud.google.com/auth/branding).
  24. - If the page says the platform is not configured, click **Get Started**.
  25. - App name: `Google Slides MCP`. User support email: your address.
  26. - Audience: **External**.
  27. - Contact email: your address. Agree to the policy. Click **Create**.
  28. - Open [Audience](https://console.cloud.google.com/auth/audience). Add your Gmail as a test user.
  29. - Open [Data Access](https://console.cloud.google.com/auth/scopes). Add `https://www.googleapis.com/auth/presentations` and `https://www.googleapis.com/auth/drive.readonly`. Save.
  30. - Open [Clients](https://console.cloud.google.com/auth/clients). Click **Create Client**. Application type: **Desktop app**. Name: `Google Slides MCP Desktop`. Click **Create**.
  31. - Copy the client id and the client secret.
  32. 5. Run `npm run start`. Paste the client id and the client secret. Finish Google consent. Then stop the process.
  33. 6. Point the host at `node /path/to/google-slides-mcp/build/index.js`. Do not set env.
  34. Example host config:
  35. ```json
  36. "google-slides-mcp": {
  37. "transportType": "stdio",
  38. "command": "node",
  39. "args": [
  40. "/path/to/google-slides-mcp/build/index.js"
  41. ]
  42. }
  43. ```
  44. Replace the path with the compiled `build/index.js` on your machine.
  45. ## First start
  46. The process opens a loopback page.
  47. - If the store has no client id or client secret, paste those two values.
  48. - Continue to Google consent.
  49. - Close the success page.
  50. The process writes the Google credential to the token store. It tries the OS keychain first. It uses `~/.config/google-slides-mcp/credential.json` if the keychain is not available. File mode is `0600`.
  51. Later starts use the store. No browser.
  52. `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, and `GOOGLE_REFRESH_TOKEN` can override one field. They are never required. If env supplies a missing field, the process writes the merged credential to the store.
  53. ## Run without a host
  54. ```bash
  55. npm run start
  56. ```
  57. The process listens on stdio. Stderr prints `Google Slides MCP server running and connected via stdio.`
  58. ## Available Tools
  59. - **`create_presentation`**: Creates a new Google Slides presentation.
  60. - **Input:**
  61. - `title` (string, required): The title for the new presentation.
  62. - **Output:** JSON object representing the created presentation details.
  63. - **`get_presentation`**: Retrieves details about an existing presentation.
  64. - **Input:**
  65. - `presentationId` (string, required): The ID of the presentation to retrieve.
  66. - `fields` (string, optional): A field mask (e.g., "slides,pageSize") to limit the returned data.
  67. - **Output:** JSON object representing the presentation details.
  68. - **`batch_update_presentation`**: Applies a series of updates to a presentation. This is the primary method for modifying slides (adding text, shapes, images, creating slides, etc.).
  69. - **Input:**
  70. - `presentationId` (string, required): The ID of the presentation to update.
  71. - `requests` (array, required): An array of request objects defining the updates. Refer to the [Google Slides API `batchUpdate` documentation](https://developers.google.com/slides/api/reference/rest/v1/presentations/batchUpdate#requestbody) for the structure of individual requests.
  72. - `writeControl` (object, optional): Controls write request execution (e.g., using revision IDs).
  73. - **Output:** JSON object representing the result of the batch update.
  74. - **`get_page`**: Retrieves details about a specific page (slide) within a presentation.
  75. - **Input:**
  76. - `presentationId` (string, required): The ID of the presentation to retrieve.
  77. - `pageObjectId` (string, required): The object ID of the page (slide) to retrieve.
  78. - **Output:** JSON object representing the page details.
  79. - **`summarize_presentation`**: Extracts and formats all text content from a presentation for easier summarization.
  80. - **Input:**
  81. - `presentationId` (string, required): The ID of the presentation to summarize.
  82. - `include_notes` (boolean, optional): Whether to include speaker notes in the summary. Defaults to false.
  83. - **Output:** JSON object containing:
  84. - `title`: The presentation's title
  85. - `slideCount`: Total number of slides
  86. - `lastModified`: Revision information
  87. - `slides`: Array of slide objects containing:
  88. - `slideNumber`: Position in presentation
  89. - `slideId`: Object ID of the slide
  90. - `content`: All text extracted from the slide
  91. - `notes`: Speaker notes (if requested and available)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.