google-workspace

name	google-workspace
version	0.0.0
description	Google Workspace automation: Drive (44 tools), Gmail (39), Calendar (22), Sheets (33), Slides (25), Docs (26), Tasks (13), Forms (16). Use when the user asks to manage files, search email, draft replies, schedule meetings, create spreadsheets, analyze data, build presentations, write documents, manage tasks, or build forms.
metadata	{"requires":{"bins":[]}}

Google Workspace Assistant

Tools are prefixed by service: drive_*, gmail_*, calendar_*, sheets_*, slides_*, docs_*, tasks_*, forms_*.

Quick Start

Task	Pattern
Search email	gmail_search_messages → gmail_get_message / gmail_get_thread
Draft reply	gmail_create_draft_reply (threaded) — never send without review
Get attachment	gmail_get_message → gmail_get_attachment
Bulk labels	gmail_batch_modify for mass archive/label/mark-read
Manage filters	gmail_list_filters → gmail_create_filter / gmail_delete_filter
Vacation reply	gmail_get_vacation_responder → gmail_update_vacation_responder
Find files	drive_search_files (by name, fullText, mimeType)
Read file	drive_read_file (returns content, truncated at 500KB)
Export file	drive_export_as — PDF, DOCX, XLSX, CSV from Workspace files
Comment on file	drive_get_comments → drive_add_comment / drive_create_reply
Drive history	drive_list_revisions / drive_get_start_page_token → drive_list_changes
Folder path	drive_get_folder_path to see full path to a file
Schedule	calendar_find_freebusy → present options → calendar_create_event
Meet event	calendar_create_event with createMeetLink:true
Calendar settings	calendar_get_setting with setting:"timezone"
Quick schedule	calendar_quick_add_event (natural language, e.g. "Lunch tomorrow noon")
Recurring	calendar_create_event_series with recurrence rule
RSVP	calendar_respond_to_event → YES/NO/MAYBE
Prep meeting	calendar_get_event → gmail_search_messages by attendees → drive_search_files
Create sheet	sheets_create_spreadsheet → sheets_batch for compound setup
Analyze data	sheets_get_spreadsheet → sheets_read_range → compute → sheets_write_range
Multi-range read	sheets_batch_get — read multiple ranges in one call
Find/replace sheet text	sheets_find_text → sheets_replace_text with TextFinder options
Insert/delete rows	sheets_insert_rows / sheets_delete_rows
Validation	sheets_set_data_validation for dropdowns, checkboxes, rules
Protect sheets/ranges	sheets_list_protections → sheets_protect_range / sheets_protect_sheet / sheets_remove_protection
Conditional fmt	sheets_get_conditional_formatting → read existing rules
Create slides	slides_create_presentation → slides_batch for compound setup
Build slides	slides_add_slide with titleText + bodyText (one call per slide) → slides_insert_text_box only for extra boxes → slides_insert_image/slides_insert_table for visuals
Slide background	slides_set_slide_background with hex color
Tune slide elements	slides_get_element → slides_update_element_geometry / slides_set_element_alt_text / slides_set_element_link
Write document	docs_create_document → docs_batch for compound setup
Format document	docs_insert_paragraph with heading → docs_format_text for styling
Doc as JSON	docs_get_as_json — full structured document tree
Doc navigation	docs_create_bookmark / docs_create_named_range → docs_list_table_of_contents when TOCs already exist
Manage tasks	tasks_list_tasklists → tasks_list_tasks → tasks_create_task / tasks_update_task
Build form	forms_create_form → forms_add_item / forms_batch → forms_get_form

When to Load References

Reference	Load When
references/tool-catalog.md	You need a compact tool list, parameter names, or descriptions
references/workflows.md	User's request matches a common pattern (meeting prep, email triage, dashboard)
references/rules.md	You need safety rules, search syntax, or parameter formatting

Read the relevant reference file before executing complex multi-tool workflows.

Critical Rules (read references/rules.md for full list)

• Never send email without explicit approval — always draft first
• Never delete/trash files, emails, or events without confirmation
• Never create forwarding filters or enable/change an enabled vacation responder without confirmation
• Never create calendar events/calendars without suggesting the details and getting approval
• Never calendar_delete_calendar without confirmation; it rejects primary/default calendars server-side
• Never sheets_delete_sheet, sheets_clear_range, or sheets_delete_rows without confirmation
• Never sheets_remove_protection without confirmation
• Never drive_remove_parent, drive_remove_editor / drive_remove_viewer, drive_delete_comment, or drive_delete_reply without confirmation
• Never tasks_delete_tasklist, tasks_delete_task, or tasks_clear_completed without confirmation
• Never forms_remove_response_destination, forms_delete_item, forms_delete_response, or forms_delete_all_responses without confirmation
• Use sheets_batch for compound spreadsheet operations (one round-trip vs many)
• Use sheets_batch_get to read multiple ranges in a single API call
• Handle errors: partial failures in sheets_batch / drive_batch / calendar_batch etc. are collected per-operation — check results[].success
• Rate limits: each service allows ~100 weighted request units per 60s; on RATE_LIMITED, wait ~60–70s and retry once — batches cost the sum of their child operations
• Deletes are trash-first for Drive (drive_trash_file is recoverable; prefer it over drive_delete_file); deleted Tasks lists may linger in listings briefly while tasks_get_tasklist already returns NOT_FOUND