google-workspace-byok
Google Calendar and Gmail integration using your own GCP project credentials (BYoK — Bring Your Own Key). Direct OAuth2 auth against your own Google Cloud project. Read calendars, events, and emails across multiple Google accounts. Use this skill when users want to check their calendar, read emails, or manage schedules. Supports: listing/reading emails, Gmail search queries, downloading attachments, extracting text from PDF attachments, listing calendars, listing/getting events, checking free/busy status, and managing multiple Google accounts.
Why use this skill?
Integrate Gmail and Google Calendar directly with your OpenClaw agent using your own GCP credentials for secure, private management of your schedules and inbox.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/kyesh/google-workspace-byokWhat This Skill Does
The google-workspace-byok skill provides a secure, direct bridge between your OpenClaw agent and your Google ecosystem. By leveraging your own Google Cloud Platform (GCP) project credentials, this skill ensures that all communication with Gmail and Google Calendar is handled through your own OAuth2 infrastructure, bypassing third-party middlemen. It supports robust interactions, including reading emails, executing advanced Gmail search queries, parsing PDF attachments, checking your free/busy status, and managing events across multiple distinct Google accounts. It is designed for privacy-conscious users who want full control over their data access layer.
Installation
To install this skill, run clawhub install openclaw/skills/skills/kyesh/google-workspace-byok in your terminal. Ensure Node.js (v18+) is installed. You must configure a GCP project with both Gmail and Calendar APIs enabled and create a 'Desktop app' OAuth credential. After saving your downloaded JSON credentials, execute the setup command: node {baseDir}/scripts/setup.js --credentials /path/to/credentials.json. Finally, authorize your specific accounts using node {baseDir}/scripts/auth.js --account <label>. Remember that apps in 'Testing' mode require adding email addresses to the test users list in the Google Cloud Console.
Use Cases
This skill is ideal for professionals needing to reconcile multiple calendars (e.g., work and personal) without manually switching tabs. It allows for high-level tasks like 'Find the PDF invoice in my emails from last week' or 'Determine when I have a 30-minute opening on Thursday.' It is also powerful for automated inbox management, such as searching for specific project-related keywords or summarizing upcoming event conflicts.
Example Prompts
- "Check my work calendar and tell me if I have any meetings tomorrow afternoon."
- "Search my emails for the flight confirmation from last night and tell me the departure time."
- "List all my events for Monday and flag any scheduling conflicts."
Tips & Limitations
Note that apps in 'Testing' status have a 7-day token expiration; you must publish to 'Production' for persistent access. For personal Gmail accounts, you may encounter an 'unverified app' screen—this is expected and safe for personal use. Always be mindful of your API quota usage in GCP, and ensure that your local credentials file is stored securely.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-kyesh-google-workspace-byok": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, external-api, network-access