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
Install
npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/google-slides
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
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 slideTITLE_AND_BODY- Title with body textTITLE_AND_TWO_COLUMNS- Title with two text columnsTITLE_ONLY- Title bar onlySECTION_HEADER- Section dividerONE_COLUMN_TEXT- Single column textMAIN_POINT- Main point highlightBIG_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.
Reviews (0)
No reviews yet.
No comments yet.