# Gws Calendar Insert

Google Calendar: Create a new event.

- Repository: https://github.com/googleworkspace/cli (32044 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add googleworkspace/cli --skill gws-calendar-insert -g -a claude-code -y`
Codex: `npx skills add googleworkspace/cli --skill gws-calendar-insert -g -a codex -y`
Cursor: `npx skills add googleworkspace/cli --skill gws-calendar-insert -g -a cursor -y`
Gemini CLI: `npx skills add googleworkspace/cli --skill gws-calendar-insert -g -a gemini-cli -y`

## Description

Google Calendar: Create a new event.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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