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