# Google Workspace Automation

> Automates Google Workspace tasks like searching and sending Gmail, managing Calendar events, finding files in Drive, and reading/creating Google Docs. Use when the user asks to check email, send an email, list calendar events, find documents, or read/create a Google Doc.

- Skill: `claio0128/google-workspace-automation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add claio0128/google-workspace-automation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/claio0128/google-workspace-automation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: claio0128 (https://skillmd.com/u/claio0128)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/claio0128/google-workspace-automation

---


# Google Workspace Automation (Python Version)

This skill provides tools to interact with your Gmail, Calendar, Drive, and Docs using authenticated **Python** scripts.

## When to Use
- **Gmail:** Searching messages, finding specific emails, and **sending emails**.
- **Calendar:** Listing upcoming events, adding new appointments/reminders.
- **Drive:** Searching for files by name or type, finding links and document IDs.
- **Docs:** Reading or creating Google Docs for summarization, analysis, or research notes.

## Available Tools (Python Scripts)

### 1. Gmail
- **Search:** `python3 scripts/search_gmail.py "<query>" [max_results]`
  *   *Example:* `python3 scripts/search_gmail.py "after:2026-03-01 TJ Drumline" 5`
- **Send:** `python3 scripts/send_gmail.py "<to>" "<subject>" "<body>"`
  *   *Example:* `python3 scripts/send_gmail.py "recipient@example.com" "Hello" "This is a test body."`

### 2. Calendar
- **List Events:** `python3 scripts/list_calendar_events.py [max_results]`
  *   *Example:* `python3 scripts/list_calendar_events.py 10`
- **Add Event:** `python3 scripts/add_calendar_event.py "<summary>" "<description>" "<start_iso>" "<end_iso>"`
  *   *Example:* `python3 scripts/add_calendar_event.py "Sync" "Details" "2026-03-06T10:00:00" "2026-03-06T11:00:00"`

### 3. Drive & Docs
- **Find Files:** `python3 scripts/find_files.py "<query>"`
  *   Find IDs and links for files in Google Drive.
  *   *Example:* `python3 scripts/find_files.py "resume"`
- **Read Google Doc:** `python3 scripts/read_google_doc.py "<document_id>"`
  *   Retrieve the full text from a Google Doc by its ID.
  *   *Example:* `python3 scripts/read_google_doc.py "1IFqEYfSYL4H-uFUzjNjTgZqlyE5S8D1BYEmEDoVHu8w"`
- **Create Google Doc:** `python3 scripts/create_google_doc.py "<title>" "<body>"`
  *   Create a new Google Doc with specified content.
  *   *Example:* `python3 scripts/create_google_doc.py "Meeting Notes" "Points discussed..."`

