gws-calendar-insert

googleworkspace/cli/gws-calendar-insert

gws-calendar-insert is a Google Workspace CLI skill for creating new events in Google Calendar. It is provided via the gws command-line tool, allowing users to specify an event summary, start and end times, and optionally set the calendar, location, description, attendees, and add a Google Meet video conference link. Before using this skill, you should read the gws-shared skill for authentication and global flags. The command format is `gws calendar +insert --summary <TEXT> --start <TIME> --end <TIME>`, where summary, start, and end are required. Times should be in RFC3339 format (e.g., 2026-06-17T09:00:00-07:00). This is a write command, so confirm with the user before executing.

安裝量 · 240查看來源

Installation

npx skills add https://googleworkspace/cli/

技能檔案

SKILL.md

最近同步 · 2026年9月30日

SKILL.md›

---
name: gws-calendar-insert
description: "Google Calendar: Create a new event."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws calendar +insert --help"
---

# 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 [email protected]
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