- name
- ez-google
- description
- Use when asked to send email, check inbox, read emails, check calendar, schedule meetings, create events, search Google Drive, create Google Docs, read or write spreadsheets, find contacts, or any task involving Gmail, Google Calendar, Drive, Docs, Sheets, Slides, or Contacts. Agent-friendly with hosted OAuth - no API keys needed.
- metadata
- {"openclaw":{"emoji":"📧"}}
ez-google
Agent-friendly Google Workspace tools. Simple CLI scripts with hosted OAuth - users just click a link and paste back a token. No API keys or credentials needed.
Run all commands with: uv run scripts/<script>.py <command> [args]
Auth (do this first)
auth.py status # Check: AUTHENTICATED or NOT_AUTHENTICATED
auth.py login # Get URL → send to user
auth.py save '<TOKEN>' # Save token from hosted OAuthAuth flow: status → if not authenticated → login → user clicks link, copies token → save '<TOKEN>'
Gmail
gmail.py list [-n 10] [-q "query"] # List emails
gmail.py search "query" # Search emails
gmail.py get MESSAGE_ID # Read email
gmail.py send "to" "subject" "body" # Send email
gmail.py draft "to" "subject" "body" # Create draft
gmail.py labels # List labels
# Bulk operations (up to 1000 messages per API call)
gmail.py bulk-label "query" --add LABEL --remove LABEL # Add/remove labels
gmail.py bulk-trash "query" [-y] # Move to trash (use -y to skip confirmation)Bulk examples:
gmail.py bulk-label "from:newsletter@example.com" --add ARCHIVE --remove INBOX
gmail.py bulk-trash "subject:alert older_than:30d" -y
gmail.py bulk-label "category:promotions" --add Label_3 # Use label IDs from `labels`Calendar
gcal.py list [DATE] # List events (DATE: YYYY-MM-DD or "today")
gcal.py create "title" "START" "END" # Create event (START/END: YYYY-MM-DDTHH:MM)
gcal.py get EVENT_ID # Event details
gcal.py delete EVENT_ID # Delete event
gcal.py calendars # List calendarsDrive
drive.py list [-n 20] # List files
drive.py search "query" # Search by name
drive.py get FILE_ID # File metadata
drive.py download FILE_ID # File content
drive.py create-folder "name" # Create folderDocs
docs.py create "title" # Create doc
docs.py get DOC_ID # Read content
docs.py find "query" # Find by title
docs.py append DOC_ID "text" # Append text
docs.py insert DOC_ID "text" # Insert at start
docs.py replace DOC_ID "old" "new" # Replace textSheets
sheets.py create "title" # Create spreadsheet
sheets.py get ID "Sheet!A1:D10" # Read data
sheets.py info ID # Sheet metadata
sheets.py find "query" # Find by name
sheets.py write ID "Sheet!A1" "a,b;c,d" # Write (rows separated by ;)
sheets.py append ID "Sheet!A:B" "a,b;c,d" # Append rowsSlides
slides.py find "query" # Find presentations
slides.py get PRESENTATION_ID # Get slides info
slides.py text PRESENTATION_ID # Extract all text
slides.py create "title" # Create presentationPeople/Contacts
people.py me # Current user profile
people.py contacts [-n 100] # List contacts
people.py search "name" # Search contacts
people.py get CONTACT_ID # Contact detailsChat (Workspace only)
chat.py spaces # List spaces
chat.py messages SPACE_ID [-n 20] # List messages
chat.py send SPACE_ID "text" # Send message
chat.py get SPACE_ID # Space detailsNote: After adding new services, run auth.py logout then login again to grant new permissions.