google-calendar

Manage Google Calendar events via the gws CLI with JSON output.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/dbbaskette/herald --skill google-calendar-dbbaskette
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-calendar
Source: https://github.com/dbbaskette/herald/tree/main/skills/google-calendar
Command: npx skills add https://github.com/dbbaskette/herald --skill google-calendar-dbbaskette

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Replaces manual calendar management with CLI-based Google Calendar control, enabling quick, scriptable scheduling and lookup without a GUI.

Core Features & Use Cases

  • Schedule events on Google Calendar via the gws CLI
  • List, search, and delete events from the command line
  • Check availability and find free time slots across calendars
  • Use in automation workflows to schedule meetings or respond to scheduling requests

Quick Start

Schedule a meeting on my Google Calendar using gws and I will create the event with the correct time and details.

Frequently Asked Questions about google-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Google Calendar from the command line?

You can manage Google Calendar from the command line using the gws CLI to schedule events, list and delete entries, and check availability. It replaces manual GUI interactions by outputting parseable JSON for scriptable automation.

How do I check calendar availability and find free time slots via CLI?

To check calendar availability and find free time slots via CLI, use the gws tool to query across your calendars. It returns parseable JSON data indicating open slots, which is useful for automation workflows.

Do I need gws installed to automate Google Calendar scheduling?

Yes, you need the gws CLI installed and authenticated to automate Google Calendar scheduling. The tool relies on gws to execute command-line operations for creating events and checking availability.

What is the best way to script meeting scheduling without a calendar GUI?

The best way to script meeting scheduling without a calendar GUI is using a CLI tool like gws. It allows you to create events with correct times and details programmatically, outputting parseable JSON for automation.

What timestamp format is required for Google Calendar CLI event creation?

RFC3339 timestamps are required for Google Calendar CLI event creation. Using the gws tool, you must format your event start and end times according to this standard to ensure accurate scheduling.