Gws Calendar Insert
Create Google Calendar events from your agent via the `gws` CLI without opening the Calendar UI.
Overview
gws-calendar-insert is an agent skill for the Build phase that creates Google Calendar events through the `gws calendar +insert` command.
Install
npx skills add https://github.com/googleworkspace/cli --skill gws-calendar-insertWhat is this skill?
- Creates events on primary or a specific calendar ID with required summary, start, and end times
- Supports optional location, description, repeated `--attendee` emails, and `--meet` for Google Meet links
- Documents 6 CLI flags plus calendar default and RFC3339/ISO 8601 time formatting tips
- Requires `gws` on PATH and the sibling `gws-shared` skill for auth and security rules
- Exposes `gws calendar +insert --help` as the canonical CLI reference for agents
- 6 documented CLI flags for calendar insert (calendar, summary, start, end, location, description, attendee, meet—table l
- Requires `gws` binary per skill metadata openclaw.requires.bins
Adoption & trust: 25k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want your agent to book calendar time in Google Workspace without manually copying fields into the Calendar web app.
Who is it for?
Builders who already installed `gws`, follow gws-shared auth rules, and need repeatable agent-driven event creation.
Skip if: Teams without Google Workspace OAuth setup, or anyone who needs bulk migration, recurrence rules, or calendar analytics instead of single-event inserts.
When should I use this skill?
You need the agent to create a new Google Calendar event via `gws calendar +insert` with summary, start, end, and optional attendees or Meet.
What do I get? / Deliverables
Your agent emits a valid `gws calendar +insert` invocation with ISO/RFC3339 times and optional attendees or a Meet link once `gws` auth is configured.
- Shell command string for `gws calendar +insert` with validated timestamps
- Optional Google Meet link on the created event when `--meet` is used
Recommended Skills
Journey fit
Calendar creation is an external API/CLI hook you wire in while building agent workflows and productivity automations. Fits the integrations shelf because it depends on the Google Workspace `gws` binary, shared auth rules, and OAuth-scoped API access.
How it compares
Use as a focused CLI recipe skill rather than a full Google Calendar MCP server or hand-rolled REST snippets without shared auth guardrails.
Common Questions / FAQ
Who is gws-calendar-insert for?
Solo and indie builders automating Google Workspace from Claude Code, Cursor, or Codex agents that can run the `gws` binary after OAuth is configured.
When should I use gws-calendar-insert?
During Build integrations work when you need to schedule standups, reviews, or client calls; also handy in Grow lifecycle flows when agents log follow-up meetings after support or sales touchpoints.
Is gws-calendar-insert safe to install?
Treat it like any CLI integration that touches your Google account: review the Security Audits panel on this Prism page and confirm `gws-shared` auth and least-privilege scopes before letting an agent run inserts.
SKILL.md
READMESKILL.md - Gws Calendar Insert
# calendar +insert > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. create a new event ## Usage ```bash gws calendar +insert --summary <TEXT> --start <TIME> --end <TIME> ``` ## Flags | Flag | Required | Default | Description | |------|----------|---------|-------------| | `--calendar` | — | primary | Calendar ID (default: primary) | | `--summary` | ✓ | — | Event summary/title | | `--start` | ✓ | — | Start time (ISO 8601, e.g., 2024-01-01T10:00:00Z) | | `--end` | ✓ | — | End time (ISO 8601) | | `--location` | — | — | Event location | | `--description` | — | — | Event description/body | | `--attendee` | — | — | Attendee email (can be used multiple times) | | `--meet` | — | — | Add a Google Meet video conference link | ## Examples ```bash gws calendar +insert --summary 'Standup' --start '2026-06-17T09:00:00-07:00' --end '2026-06-17T09:30:00-07:00' gws calendar +insert --summary 'Review' --start ... --end ... --attendee alice@example.com gws calendar +insert --summary 'Meet' --start ... --end ... --meet ``` ## Tips - Use RFC3339 format for times (e.g. 2026-06-17T09:00:00-07:00). - The --meet flag automatically adds a Google Meet link to the event. > [!CAUTION] > This is a **write** command — confirm with the user before executing. ## See Also - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth - [gws-calendar](../gws-calendar/SKILL.md) — All manage calendars and events commands