ez-google

What This Skill Does

ez-google provides a comprehensive suite of tools for the OpenClaw agent to interact directly with the Google Workspace ecosystem. It serves as a unified bridge between the agent and your personal or work data, covering Gmail, Google Calendar, Google Drive, Google Docs, Google Sheets, Google Slides, and Google Contacts. By leveraging a hosted OAuth flow, the skill eliminates the complex hurdle of manual API key management; users simply authenticate once, and the agent gains the capability to perform CRUD operations across the entire suite. Whether it is searching for an attachment in Drive, drafting an email, or appending data to a spreadsheet, ez-google standardizes these workflows through simple CLI-based scripting.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/araa47/ez-google

Once installed, initialize your connection by running uv run scripts/auth.py login. Follow the link provided in the console, authorize your account, and paste the resulting token into uv run scripts/auth.py save '<TOKEN>'. You can verify your connection at any time using uv run scripts/auth.py status.

Use Cases

This skill is perfect for automating administrative overhead. Use it to: 1) Triage your email inbox by filtering, labeling, or deleting outdated messages in bulk. 2) Manage your schedule by querying current events and automatically creating meeting invitations based on project discussions. 3) Collaborate on documentation or data analysis by creating and updating files in Drive, Docs, or Sheets directly through the agent interface. 4) Extract and organize information from presentations or long email chains.

Example Prompts

1. "Find the email from my manager about the Q3 project update and summarize the action items for me."
2. "Look at my calendar for today. If I have any meetings between 2 PM and 4 PM, move them to tomorrow and notify the participants via email."
3. "Search my Drive for the 'Budget 2024' spreadsheet, read the first 10 rows, and append a new entry for the marketing expenses."

Tips & Limitations

Always check the specific script documentation for required formats, particularly for Google Sheets, where ranges and row separators (using ';' and ',') are mandatory. The bulk operations in Gmail are powerful tools, but be cautious with automated deletions; it is recommended to test your search queries with a simple list command first to ensure the correct emails are targeted. The skill relies on the user performing the initial OAuth handshake, which only needs to be completed once. Since this skill interacts with sensitive personal data, ensure your OpenClaw agent has appropriate access controls enabled to prevent unauthorized modifications to your workspace.