Google Slides MCP Server

An MCP server for managing Google Slides presentations, integrating seamlessly with AI assistants using the Model Context Protocol.

Features

• List Presentations: Search and list presentations via Drive API.
• Get Presentation: Retrieve full presentation structure (slides, shapes, text).
• Create Presentation: Create new presentations.
• Batch Update: Modify presentations (add slides, edit content).
• Page Details: Get specific slide content.
• Thumbnails: Generate thumbnail URLs for slides.

Scope

This server focuses on Google Slides presentation management through MCP tools:

• Read/list presentations from Google Drive.
• Read full presentation/slide details.
• Create new presentations.
• Perform Slides API batchUpdate operations.
• Generate slide thumbnails.

It does not implement custom business workflows on top of Slides; callers provide valid Google Slides API request payloads (especially for batch_update_presentation).

Installation

Prerequisites

• Python 3.9 or higher.
• A Google Cloud Project with the Slides and Drive APIs enabled.
• OAuth2 credentials (Client ID and Client Secret).
• OAuth2 tokens with required scopes.

Required OAuth Scopes

• https://www.googleapis.com/auth/drive.readonly
• https://www.googleapis.com/auth/presentations

You can optionally pass scopes through --scopes as a JSON array string.

Local Setup

1. Install dependencies:

   pip install -e .
   

2. Run the server:

   python main.py --access-token <TOKEN> --refresh-token <REFRESH_TOKEN> --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET>
   

Configuration

Add the following to your MCP host configuration (e.g., mcp-config.json):

{
  "mcpServers": {
    "barie-google-slides-mcp": {
      "command": "uvx",
      "args": [
        "barie-google-slides-mcp",
        "--access-token",
        "YOUR_ACCESS_TOKEN",
        "--refresh-token",
        "YOUR_REFRESH_TOKEN",
        "--client-id",
        "YOUR_CLIENT_ID",
        "--client-secret",
        "YOUR_CLIENT_SECRET"
      ]
    }
  }
}

Optional:

• --expiry: token expiry timestamp in ISO format (for example 2026-05-07T00:00:00Z).
• --scopes: JSON array string of scopes. If omitted, server defaults are used.

Tools

• list_presentations: Search and list presentations.
• get_presentation: Get presentation content.
• create_presentation: Create a new presentation.
• batch_update_presentation: Update presentation structure/content.
• get_page: Get specific slide content.
• get_page_thumbnail: Get thumbnail URL for a slide.

Notes

• list_presentations.pageSize supports values from 1 to 100.
• batch_update_presentation.requests must follow Google Slides API presentations.batchUpdate request objects.

License

MIT