Skip to content
TakoAPI
Back to skills

google-workspace-byok

by kyesh

Web & Frontend Development
506Downloads reported by clawskills.sh
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Google Calendar and Gmail integration using your own GCP project credentials (BYoK — Bring Your Own Key)

Description

What This Skill Does

Connects Google Calendar and Gmail to an AI agent using OAuth2 credentials from your own Google Cloud project. Supports multiple Google accounts under user-defined labels. Covers listing and searching emails, downloading attachments, extracting text from PDF attachments, reading calendar events, and checking free/busy status.

Because credentials are tied to your own GCP project, OAuth tokens and API access never pass through a third-party service.

When to Use It

  • Checking this week's meetings across personal and work calendars
  • Searching Gmail for unread emails from a specific sender
  • Downloading and reading PDF invoices or school letters from email attachments
  • Checking free/busy windows before proposing a meeting time
  • Listing recent emails and summarizing their subjects

Example Workflow

INPUT

User asks: Do I have any meetings tomorrow, and are there unread emails from my manager?

AGENT
  1. 1

    Run calendar.js --account work --action events --days 2 to fetch upcoming events

  2. 2

    Filter results to events occurring tomorrow

  3. 3

    Run gmail.js --account work --action list --query "from:manager@example.com is:unread" to fetch matching emails

  4. 4

    Read each matching email with --action read to get subject and snippet

OUTPUT

A summary of tomorrow's calendar events and a list of unread emails from the manager with subjects and previews

Requirements

  • Google Cloud project with Calendar API and Gmail API enabled
  • OAuth2 Desktop app credentials JSON downloaded from GCP Console
  • Google account(s) added as test users in GCP OAuth consent screen (while app is in Testing status)

Installation

clawhub install kyesh/google-workspace-byok

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links