Skip to content
TakoAPI
Back to skills

google-calendar

by adrianmiller99

Calendar & Scheduling
10.4kDownloads reported by clawskills.sh
11Stars
18Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Interact with Google Calendar via the Google Calendar.

Description

What This Skill Does

Wraps the Google Calendar REST API to list, create, update, and delete calendar events from the command line or automated scripts. Credentials are stored as environment variables and authentication uses OAuth 2.0 refresh tokens. Works headless, no browser or GUI required at runtime.

Runs headless on servers and in CI pipelines where a browser-based calendar UI is not available.

When to Use It

  • Listing today's meetings before a standup call
  • Creating a calendar event from a task automation script
  • Bulk-deleting cancelled appointments by event ID
  • Checking what's scheduled across a specific date range
  • Adding attendees and a location to a new event programmatically

Example Workflow

INPUT

User asks: Schedule a team sync tomorrow at 2pm with alice@example.com and bob@example.com

AGENT
  1. 1

    Reads GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN from environment

  2. 2

    Refreshes the OAuth access token using the stored refresh token

  3. 3

    Calls google-calendar add --title "Team sync" --start <ISO> --end <ISO> --attendees alice@example.com,bob@example.com

  4. 4

    Google Calendar API creates the event and returns event metadata as JSON

  5. 5

    Prints the JSON payload including the new event ID to stdout

OUTPUT

JSON object with event ID, title, start/end times, and attendee list

Requirements

  • Google Cloud project with the Google Calendar API enabled
  • OAuth 2.0 Desktop app credentials (client ID and client secret) from Google Cloud Console
  • GOOGLE_REFRESH_TOKEN obtained by running the provided auth helper script and completing the OAuth consent flow
  • GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN set via `openclaw secret set`

Installation

clawhub install adrianmiller99/google-calendar

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

Links