Claude Skill

google-slides

Read and write Google Slides presentations - get text, find presentations, create presentations, add slides, replace text, and manage slide content. Use when user asks to: read a presentation, create slides, find slides, add a slide, replace text in a presentation, or manage pres

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download sanjay3290-ai-skills-skills_google-slides-c842558.zip · 10 KB

Install

skills CLI npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/google-slides
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
Git git clone https://github.com/sanjay3290/ai-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole sanjay3290/ai-skills collection as a plugin from our marketplace. Git is the plain clone.

README

Google Slides Skill

An AI agent skill for reading Google Slides presentations - get text content, find presentations, and retrieve metadata. Works with Claude Code, Gemini CLI, Cursor, OpenAI Codex, Goose, and other AI clients supporting the Agent Skills Standard.

Features

  • Extract Text - Get all text content from presentations
  • Search - Find presentations by name
  • Metadata - View slide count, dimensions, and properties

Read-only access. Lightweight alternative to the full Google Workspace MCP server.

⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.

Quick Start

1. Install dependencies

pip install keyring

2. Authenticate

python scripts/auth.py login

This opens a browser for Google OAuth. Tokens are stored securely in your system keyring.

3. Test connection

python scripts/auth.py status

Usage Examples

# Get all text content from a presentation
python scripts/slides.py get-text "1abc123xyz789"
python scripts/slides.py get-text "https://docs.google.com/presentation/d/1abc123xyz789/edit"

# Find presentations by search query
python scripts/slides.py find "quarterly report"
python scripts/slides.py find "project proposal" --limit 5

# Get presentation metadata (title, slide count, etc.)
python scripts/slides.py get-metadata "1abc123xyz789"

Command Reference

Command Description Arguments
get-text <id> Extract all text presentation ID or URL
find <query> Search presentations search query, --limit
get-metadata <id> Get presentation info presentation ID

Output Formats

get-text

Returns extracted text from all slides:

  • Presentation title
  • Text from shapes/text boxes
  • Table data with cell contents

find

{
  "presentations": [
    {"id": "1abc...", "name": "Q4 Report", "modifiedTime": "2024-01-15T..."}
  ]
}

get-metadata

{
  "presentationId": "1abc...",
  "title": "My Presentation",
  "slideCount": 15,
  "pageSize": {"width": {...}, "height": {...}}
}

Presentation ID Format

You can use either:

  • Direct ID: 1abc123xyz789
  • Full URL: https://docs.google.com/presentation/d/1abc123xyz789/edit

The scripts automatically extract the ID from URLs.

Token Management

Tokens stored securely using the system keyring:

  • macOS: Keychain
  • Windows: Windows Credential Locker
  • Linux: Secret Service API (GNOME Keyring, KDE Wallet)

Service name: google-slides-skill-oauth

Troubleshooting

"Failed to get access token"

Run python scripts/auth.py login to authenticate.

"Presentation not found"

Check the presentation ID and your access permissions.

License

Apache 2.0

Skill manifest

Google Slides

Lightweight Google Slides integration with standalone OAuth authentication. No MCP server required. Full read/write access.

Requires Google Workspace account. Personal Gmail accounts are not supported.

First-Time Setup

Authenticate with Google (opens browser):

python scripts/auth.py login

Check authentication status:

python scripts/auth.py status

Logout when needed:

python scripts/auth.py logout

Read Commands

All operations via scripts/slides.py. Auto-authenticates on first use if not logged in.

# Get all text content from a presentation
python scripts/slides.py get-text "1abc123xyz789"
python scripts/slides.py get-text "https://docs.google.com/presentation/d/1abc123xyz789/edit"

# Find presentations by search query
python scripts/slides.py find "quarterly report"
python scripts/slides.py find "project proposal" --limit 5

# Get presentation metadata (title, slide count, slide object IDs)
python scripts/slides.py get-metadata "1abc123xyz789"

Write Commands

# Create a new empty presentation
python scripts/slides.py create "Q4 Sales Report"

# Add a blank slide to the end
python scripts/slides.py add-slide "1abc123xyz789"

# Add a slide with a specific layout
python scripts/slides.py add-slide "1abc123xyz789" --layout TITLE_AND_BODY

# Add a slide at a specific position (0-based index)
python scripts/slides.py add-slide "1abc123xyz789" --layout TITLE --at 0

# Find and replace text across all slides
python scripts/slides.py replace-text "1abc123xyz789" "old text" "new text"
python scripts/slides.py replace-text "1abc123xyz789" "Draft" "Final" --match-case

# Delete a slide by object ID (use get-metadata to find IDs)
python scripts/slides.py delete-slide "1abc123xyz789" "g123abc456"

# Batch update (advanced - for formatting, inserting shapes, images, etc.)
python scripts/slides.py batch-update "1abc123xyz789" '[{"replaceAllText":{"containsText":{"text":"foo"},"replaceText":"bar"}}]'

Slide Layouts

Available layouts for add-slide --layout:

  • BLANK - Empty slide (default)
  • TITLE - Title slide
  • TITLE_AND_BODY - Title with body text
  • TITLE_AND_TWO_COLUMNS - Title with two text columns
  • TITLE_ONLY - Title bar only
  • SECTION_HEADER - Section divider
  • ONE_COLUMN_TEXT - Single column text
  • MAIN_POINT - Main point highlight
  • BIG_NUMBER - Large number display

Presentation ID Format

You can use either:

  • Direct presentation ID: 1abc123xyz789
  • Full Google Slides URL: https://docs.google.com/presentation/d/1abc123xyz789/edit

The scripts automatically extract the ID from URLs.

Output Format

get-text

Returns extracted text from all slides, including:

  • Presentation title
  • Text from shapes/text boxes on each slide
  • Table data with cell contents

find

Returns list of matching presentations:

{
  "presentations": [
    {"id": "1abc...", "name": "Q4 Report", "modifiedTime": "2024-01-15T..."}
  ],
  "nextPageToken": "..."
}

get-metadata

Returns presentation details:

{
  "presentationId": "1abc...",
  "title": "My Presentation",
  "slideCount": 15,
  "pageSize": {"width": {...}, "height": {...}},
  "hasMasters": true,
  "hasLayouts": true
}

Token Management

Tokens stored securely using the system keyring:

  • macOS: Keychain
  • Windows: Windows Credential Locker
  • Linux: Secret Service API (GNOME Keyring, KDE Wallet, etc.)

Service name: google-slides-skill-oauth

Automatically refreshes expired tokens using Google's cloud function.

Files (ai-skills)
  • scripts
    • auth.py 12.2 KB
      Loading…
    • requirements.txt 16 B
      Loading…
    • slides.py 12.3 KB
      Loading…
  • README.md 2.8 KB
    # Google Slides Skill
    
    An AI agent skill for reading Google Slides presentations - get text content, find presentations, and retrieve metadata. Works with Claude Code, Gemini CLI, Cursor, OpenAI Codex, Goose, and other AI clients supporting the [Agent Skills Standard](https://agentskills.io).
    
    ## Features
    
    - **Extract Text** - Get all text content from presentations
    - **Search** - Find presentations by name
    - **Metadata** - View slide count, dimensions, and properties
    
    Read-only access. Lightweight alternative to the full [Google Workspace MCP server](https://github.com/gemini-cli-extensions/workspace).
    
    > **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported.
    
    ## Quick Start
    
    ### 1. Install dependencies
    
    ```bash
    pip install keyring
    ```
    
    ### 2. Authenticate
    
    ```bash
    python scripts/auth.py login
    ```
    
    This opens a browser for Google OAuth. Tokens are stored securely in your system keyring.
    
    ### 3. Test connection
    
    ```bash
    python scripts/auth.py status
    ```
    
    ## Usage Examples
    
    ```bash
    # Get all text content from a presentation
    python scripts/slides.py get-text "1abc123xyz789"
    python scripts/slides.py get-text "https://docs.google.com/presentation/d/1abc123xyz789/edit"
    
    # Find presentations by search query
    python scripts/slides.py find "quarterly report"
    python scripts/slides.py find "project proposal" --limit 5
    
    # Get presentation metadata (title, slide count, etc.)
    python scripts/slides.py get-metadata "1abc123xyz789"
    ```
    
    ## Command Reference
    
    | Command | Description | Arguments |
    |---------|-------------|-----------|
    | `get-text <id>` | Extract all text | presentation ID or URL |
    | `find <query>` | Search presentations | search query, `--limit` |
    | `get-metadata <id>` | Get presentation info | presentation ID |
    
    ## Output Formats
    
    ### get-text
    Returns extracted text from all slides:
    - Presentation title
    - Text from shapes/text boxes
    - Table data with cell contents
    
    ### find
    ```json
    {
      "presentations": [
        {"id": "1abc...", "name": "Q4 Report", "modifiedTime": "2024-01-15T..."}
      ]
    }
    ```
    
    ### get-metadata
    ```json
    {
      "presentationId": "1abc...",
      "title": "My Presentation",
      "slideCount": 15,
      "pageSize": {"width": {...}, "height": {...}}
    }
    ```
    
    ## Presentation ID Format
    
    You can use either:
    - Direct ID: `1abc123xyz789`
    - Full URL: `https://docs.google.com/presentation/d/1abc123xyz789/edit`
    
    The scripts automatically extract the ID from URLs.
    
    ## Token Management
    
    Tokens stored securely using the system keyring:
    - **macOS**: Keychain
    - **Windows**: Windows Credential Locker
    - **Linux**: Secret Service API (GNOME Keyring, KDE Wallet)
    
    Service name: `google-slides-skill-oauth`
    
    ## Troubleshooting
    
    ### "Failed to get access token"
    Run `python scripts/auth.py login` to authenticate.
    
    ### "Presentation not found"
    Check the presentation ID and your access permissions.
    
    ## License
    
    Apache 2.0
    
  • requirements.txt 16 B
    Loading…
  • SKILL.md 4 KB
    ---
    name: google-slides
    description: |
      Read and write Google Slides presentations - get text, find presentations, create presentations, add slides,
      replace text, and manage slide content. Use when user asks to: read a presentation, create slides, find slides,
      add a slide, replace text in a presentation, or manage presentation content. Lightweight integration with
      standalone OAuth authentication supporting full read/write access.
    license: Apache-2.0
    metadata:
      author: sanjay3290
      version: "1.0"
    ---
    
    # Google Slides
    
    Lightweight Google Slides integration with standalone OAuth authentication. No MCP server required. Full read/write access.
    
    > **Requires Google Workspace account.** Personal Gmail accounts are not supported.
    
    ## First-Time Setup
    
    Authenticate with Google (opens browser):
    ```bash
    python scripts/auth.py login
    ```
    
    Check authentication status:
    ```bash
    python scripts/auth.py status
    ```
    
    Logout when needed:
    ```bash
    python scripts/auth.py logout
    ```
    
    ## Read Commands
    
    All operations via `scripts/slides.py`. Auto-authenticates on first use if not logged in.
    
    ```bash
    # Get all text content from a presentation
    python scripts/slides.py get-text "1abc123xyz789"
    python scripts/slides.py get-text "https://docs.google.com/presentation/d/1abc123xyz789/edit"
    
    # Find presentations by search query
    python scripts/slides.py find "quarterly report"
    python scripts/slides.py find "project proposal" --limit 5
    
    # Get presentation metadata (title, slide count, slide object IDs)
    python scripts/slides.py get-metadata "1abc123xyz789"
    ```
    
    ## Write Commands
    
    ```bash
    # Create a new empty presentation
    python scripts/slides.py create "Q4 Sales Report"
    
    # Add a blank slide to the end
    python scripts/slides.py add-slide "1abc123xyz789"
    
    # Add a slide with a specific layout
    python scripts/slides.py add-slide "1abc123xyz789" --layout TITLE_AND_BODY
    
    # Add a slide at a specific position (0-based index)
    python scripts/slides.py add-slide "1abc123xyz789" --layout TITLE --at 0
    
    # Find and replace text across all slides
    python scripts/slides.py replace-text "1abc123xyz789" "old text" "new text"
    python scripts/slides.py replace-text "1abc123xyz789" "Draft" "Final" --match-case
    
    # Delete a slide by object ID (use get-metadata to find IDs)
    python scripts/slides.py delete-slide "1abc123xyz789" "g123abc456"
    
    # Batch update (advanced - for formatting, inserting shapes, images, etc.)
    python scripts/slides.py batch-update "1abc123xyz789" '[{"replaceAllText":{"containsText":{"text":"foo"},"replaceText":"bar"}}]'
    ```
    
    ## Slide Layouts
    
    Available layouts for `add-slide --layout`:
    - `BLANK` - Empty slide (default)
    - `TITLE` - Title slide
    - `TITLE_AND_BODY` - Title with body text
    - `TITLE_AND_TWO_COLUMNS` - Title with two text columns
    - `TITLE_ONLY` - Title bar only
    - `SECTION_HEADER` - Section divider
    - `ONE_COLUMN_TEXT` - Single column text
    - `MAIN_POINT` - Main point highlight
    - `BIG_NUMBER` - Large number display
    
    ## Presentation ID Format
    
    You can use either:
    - Direct presentation ID: `1abc123xyz789`
    - Full Google Slides URL: `https://docs.google.com/presentation/d/1abc123xyz789/edit`
    
    The scripts automatically extract the ID from URLs.
    
    ## Output Format
    
    ### get-text
    Returns extracted text from all slides, including:
    - Presentation title
    - Text from shapes/text boxes on each slide
    - Table data with cell contents
    
    ### find
    Returns list of matching presentations:
    ```json
    {
      "presentations": [
        {"id": "1abc...", "name": "Q4 Report", "modifiedTime": "2024-01-15T..."}
      ],
      "nextPageToken": "..."
    }
    ```
    
    ### get-metadata
    Returns presentation details:
    ```json
    {
      "presentationId": "1abc...",
      "title": "My Presentation",
      "slideCount": 15,
      "pageSize": {"width": {...}, "height": {...}},
      "hasMasters": true,
      "hasLayouts": true
    }
    ```
    
    ## Token Management
    
    Tokens stored securely using the system keyring:
    - **macOS**: Keychain
    - **Windows**: Windows Credential Locker
    - **Linux**: Secret Service API (GNOME Keyring, KDE Wallet, etc.)
    
    Service name: `google-slides-skill-oauth`
    
    Automatically refreshes expired tokens using Google's cloud function.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.