gws-calendar-insert — Claude Code skill: events and setup
Create Google Calendar events by giving an agent a title and time range. Add attendees, a location, event details, or a Google Meet link when needed.
npx skills add googleworkspace/cli --skill gws-calendar-insert -a claude-codeWhat gws-calendar-insert does
The skill runs gws calendar +insert. Each event needs a summary, start time, and end time in RFC3339 format. You can select a calendar and pass a location, description, attendee email addresses, or the --meet flag to add a Google Meet link.
You need the gws executable and the auth setup described in gws-shared/SKILL.md. If that file is missing, the instructions say to run gws generate-skills. This command writes to a calendar, so get user confirmation before running it. Install the skill when you want an agent to create events from a request; it is not for reading calendar data.
What it helps with
- create an event for a given time range
- invite attendees to a meeting
- set an event location and description
- add a Google Meet link to an event
Example prompts for the agent
- Add a Standup to my primary calendar on June 17, 2026, from 09:00 to 09:30 -07:00.
- Create a Review event and invite [email protected].
- Schedule a Meet for the requested time and add a Google Meet link.
How to install gws-calendar-insert
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-calendar-insert -a claude-code2Manually: put the files in place
~/.claude/skills/gws-calendar-insert/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gws-calendar-insert/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-calendar-insert -a codex2Manually: put the files in place
.agents/skills/gws-calendar-insert/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-calendar-insert -a cursor2Manually: put the files in place
.cursor/skills/gws-calendar-insert/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-calendar-insert2Manually: put the files in place
.github/skills/gws-calendar-insert/SKILL.md1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-calendar-insert -a gemini-cli2Platform CLI
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-calendar-insertManually: put the files in place
.devin/skills/gws-calendar-insert/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-calendar-insert -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set95
The whole set →Similar
Questions about gws-calendar-insert
How do I install gws-calendar-insert in Claude Code?
Run npx skills add googleworkspace/cli --skill gws-calendar-insert -a claude-code.
What does gws-calendar-insert do?
It creates a Google Calendar event with a summary, start time, and end time. You can also provide attendees, a location, a description, or --meet.
What does gws-calendar-insert need to run?
It requires the gws executable and the auth setup in gws-shared/SKILL.md. Since the command writes to a calendar, get user confirmation before running it.
Source text
SKILL.md · Apache-2.0
---
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
© googleworkspace · Apache-2.0 · googleworkspace/cli