---
id: ssh-gws-calendar-insert
name: "gws-calendar-insert"
url: https://skills.yangsir.net/skill/ssh-gws-calendar-insert
author: googleworkspace
domain: ai-productivity-automation
tags: ["google-calendar-api", "event-scheduling", "meeting-automation", "google-workspace-cli", "productivity-tools"]
install_count: 23400
rating: 4.60 (297 reviews)
github: https://github.com/googleworkspace/cli
---

# gws-calendar-insert

> 用于在Google日历中创建新的日程事件，支持设置事件标题、时间、地点等信息。

**Stats**: 23,400 installs · 4.6/5 (297 reviews)

## Before / After 对比

### 中文

## Readme

# 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) |

## 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
```

## Tips

- Use RFC3339 format for times (e.g. 2026-06-17T09:00:00-07:00).
- For recurring events or conference links, use the raw API instead.

> [!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


---
*Source: https://skills.yangsir.net/skill/ssh-gws-calendar-insert*
*Markdown mirror: https://skills.yangsir.net/api/skill/ssh-gws-calendar-insert/markdown*