How do I install the Ez Google skill?

Run npx skillmds@latest add dvcrn/ez-google in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ez Google safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ez Google?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ez Google free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ez Google?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ez Google by dvcrn — Agent Skill

Name: Ez Google
Rating: 4.5 (4 reviews)
Author: dvcrn

Ez Google

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.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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 OAuth

Auth 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 calendars

Drive

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 folder

Docs

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 text

Sheets

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 rows

Slides

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 presentation

People/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 details

Chat (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 details

Note: After adding new services, run auth.py logout then login again to grant new permissions.

---name: ez-googledescription: 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.---# ez-googleAgent-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)```bashauth.py status # Check: AUTHENTICATED or NOT_AUTHENTICATEDauth.py login # Get URL → send to userauth.py save '<TOKEN>' # Save token from hosted OAuth```**Auth flow:** `status` → if not authenticated → `login` → user clicks link, copies token → `save '<TOKEN>'`---## Gmail```bashgmail.py list [-n 10] [-q "query"] # List emailsgmail.py search "query" # Search emailsgmail.py get MESSAGE_ID # Read emailgmail.py send "to" "subject" "body" # Send emailgmail.py draft "to" "subject" "body" # Create draftgmail.py labels # List labels# Bulk operations (up to 1000 messages per API call)gmail.py bulk-label "query" --add LABEL --remove LABEL # Add/remove labelsgmail.py bulk-trash "query" [-y] # Move to trash (use -y to skip confirmation)```**Bulk examples:**```bashgmail.py bulk-label "from:newsletter@example.com" --add ARCHIVE --remove INBOXgmail.py bulk-trash "subject:alert older_than:30d" -ygmail.py bulk-label "category:promotions" --add Label_3 # Use label IDs from `labels````## Calendar```bashgcal.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 detailsgcal.py delete EVENT_ID # Delete eventgcal.py calendars # List calendars```## Drive```bashdrive.py list [-n 20] # List filesdrive.py search "query" # Search by namedrive.py get FILE_ID # File metadatadrive.py download FILE_ID # File contentdrive.py create-folder "name" # Create folder```## Docs```bashdocs.py create "title" # Create docdocs.py get DOC_ID # Read contentdocs.py find "query" # Find by titledocs.py append DOC_ID "text" # Append textdocs.py insert DOC_ID "text" # Insert at startdocs.py replace DOC_ID "old" "new" # Replace text```## Sheets```bashsheets.py create "title" # Create spreadsheetsheets.py get ID "Sheet!A1:D10" # Read datasheets.py info ID # Sheet metadatasheets.py find "query" # Find by namesheets.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 rows```## Slides```bashslides.py find "query" # Find presentationsslides.py get PRESENTATION_ID # Get slides infoslides.py text PRESENTATION_ID # Extract all textslides.py create "title" # Create presentation```## People/Contacts```bashpeople.py me # Current user profilepeople.py contacts [-n 100] # List contactspeople.py search "name" # Search contactspeople.py get CONTACT_ID # Contact details```## Chat (Workspace only)```bashchat.py spaces # List spaceschat.py messages SPACE_ID [-n 20] # List messageschat.py send SPACE_ID "text" # Send messagechat.py get SPACE_ID # Space details```---Note: After adding new services, run `auth.py logout` then `login` again to grant new permissions.

Frequently asked questions