skills/skills.volces.com/google-calendar

google-calendar

Installation
SKILL.md

Google Calendar

First-Time Setup

  1. Check if ~/.config/google-calendar-skill/client.json exists (if exists, move on to step 2 without asking, if not, point them to SETUP.md in the source repo).
  2. Run bun run auth.ts login — this opens the browser. The user signs into their Google account.
  3. After login succeeds, the script prints the authenticated email. Show it to the user.
  4. Ask the user what this account is for (e.g. "work", "personal") and optionally its purpose (e.g. "Work meetings", "Personal"). Then run:
    bun run auth.ts label <chosen-name> [purpose]
    
    If they didn't give a purpose, guess based on what they said about the account and update config.json (see Account config below): set accounts.<label>.purpose.
  5. Ask if they want to connect another Google account. If yes, repeat from step 2.
  6. After each label (if purpose wasn't passed), ensure config.json has the account's purpose.
  7. List their calendars so they can see what's available (runs for all accounts; output is labeled):
    bun run calendar.ts calendars
    
Installs
1
First Seen
Apr 6, 2026