
Gws Calendar Insert
- 38.5k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
gws-calendar-insert is a Google Workspace CLI skill that creates new calendar events.
About
This skill is a CLI command within the gws Google Workspace CLI that creates calendar events programmatically. It accepts structured arguments for event summary, start/end times, attendees, and optional details like location and Google Meet links. Developers use it to automate calendar operations, build integrations, or add event creation to workflows.
- Create Google Calendar events via CLI with ISO 8601 time format
- Support for attendees, locations, descriptions, and Google Meet links
- Integrates with gws CLI framework for Google Workspace operations
Gws Calendar Insert by the numbers
- 38,517 all-time installs (skills.sh)
- +1,250 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #22 of 690 Office & Documents skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
gws-calendar-insert capabilities & compatibility
- Works with
- google drive
- Runs
- Runs locally
- Pricing
- Free
What gws-calendar-insert says it does
create a new event
gws calendar +insert --summary <TEXT> --start <TIME> --end <TIME>
npx skills add https://github.com/googleworkspace/cli --skill gws-calendar-insertAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 38.5k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
How do you create Google Calendar events from CLI?
Create calendar events via CLI for automation, testing, or integration with other tools.
Who is it for?
Automating calendar operations, testing calendar workflows, building calendar integrations
Skip if: Read-only agenda views, recurring-event complex scheduling, or calendar changes without `gws` authentication.
When should I use this skill?
You need to create calendar events programmatically or via CLI
What you get
New calendar events with summary, start/end times, calendar ID, and API confirmation returned to the terminal.
- created calendar events
- calendar api insert responses
By the numbers
- Skill metadata version 0.22.5
- Three required CLI flags: --summary, --start, --end
Files
calendar +insert
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
create a new event
Usage
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
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 ... --meetTips
- 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 — Global flags and auth
- gws-calendar — All manage calendars and events commands
Related skills
How it compares
Use gws-calendar-insert when your automation stack already runs `gws` and you need a minimal create-event path instead of a full Calendar API client.
FAQ
Which flags are required for gws calendar +insert?
gws-calendar-insert requires `--summary` for the event title, `--start` for start time, and `--end` for end time. `--calendar` is optional and defaults to the primary calendar ID.
Can agents create events on non-primary calendars?
Yes. gws-calendar-insert accepts `--calendar` with a calendar ID to target a specific Google Calendar instead of the default primary calendar.
Is Gws Calendar Insert safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.