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
- Example:
- Send:
python3 scripts/send_gmail.py "<to>" "<subject>" "<body>"- Example:
python3 scripts/send_gmail.py "recipient@example.com" "Hello" "This is a test body."
- Example:
2. Calendar
- List Events:
python3 scripts/list_calendar_events.py [max_results]- Example:
python3 scripts/list_calendar_events.py 10
- Example:
- 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"
- Example:
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..."