Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
googleworkspace avatar

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)
At a glance

gws-calendar-insert capabilities & compatibility

Works with
google drive
Runs
Runs locally
Pricing
Free
From the docs

What gws-calendar-insert says it does

create a new event
SKILL.md
gws calendar +insert --summary <TEXT> --start <TIME> --end <TIME>
SKILL.md
npx skills add https://github.com/googleworkspace/cli --skill gws-calendar-insert

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs38.5k
repo stars30k
Security audit3 / 3 scanners passed
Last updatedJuly 22, 2026
Repositorygoogleworkspace/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

SKILL.mdMarkdownGitHub ↗

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

gws calendar +insert --summary <TEXT> --start <TIME> --end <TIME>

Flags

FlagRequiredDefaultDescription
--calendarprimaryCalendar ID (default: primary)
--summaryEvent summary/title
--startStart time (ISO 8601, e.g., 2024-01-01T10:00:00Z)
--endEnd time (ISO 8601)
--locationEvent location
--descriptionEvent description/body
--attendeeAttendee email (can be used multiple times)
--meetAdd 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 ... --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 — 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.

Office & Documentsintegrationsdevops

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.