gws-calendar-insert Skill for Claude: Create Google Calendar Events

Lets Claude create a new Google Calendar event with a title, start and end time, and optional attendees and Meet link.

Installs: 48.8K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

The skill teaches the agent one command, gws calendar +insert. The title, start and end are required. Location, description, attendees and a Google Meet link are optional. Times use RFC3339 format, for example 2026-06-17T09:00:00-07:00.

This is a write command, and SKILL.md says to confirm with you before running it. It needs the gws CLI signed in to your Google account, and SKILL.md tells the agent to read gws-shared first.

Good for

Anyone who wants Claude to put meetings on their calendar
Developers scripting calendar events with the gws CLI

Install gws-calendar-insert

Claude Code

Copy this prompt.

Install the gws-calendar-insert skill in Claude Code. Run this command:

npm install -g @googleworkspace/cli
gws auth setup
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-shared
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar-insert

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18+, Google Cloud project, Google account.

This skill only works with the gws command-line tool on your PATH, and its SKILL.md tells the agent to read the gws-shared skill first, so install both. gws auth setup needs the gcloud CLI; without it, use the manual OAuth steps in the README. If Google limits the sign-in screen, pick only the service you need, for example gws auth login -s drive,gmail,sheets.

From the project README. Source.

What's in the skill

When it loads

Google Calendar: Create a new event.

Sections in SKILL.md

Usage
Flags
Examples
Tips
See Also

Key facts

Author: googleworkspace
Repository: googleworkspace/cli
License: Apache-2.0
Installs on skills.sh: 48,826 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026)
Last repo commit: Oct 30, 2026
What installs: 1 file including SKILL.md (the folder holds SKILL.md only)
Needs: The gws CLI on your PATH, a Google sign-in, and the gws-shared skill (read first, per SKILL.md)
Official status: The README says gws is not an officially supported Google product

What it includes

Creates a new event with a summary, start and end time
Required flags are --summary, --start and --end. SKILL.md marks it as a write command to confirm with you first.
Try: “Add a 30 minute standup tomorrow at 9am”
Runs code · gws calendar +insert
Adds an attendee by email; repeat the flag for several people
Optional. Can be used multiple times.
Try: “Invite alice@example.com to the review”
Write · --attendee
Adds a Google Meet video link to the event
SKILL.md says the flag automatically adds a Google Meet link.
Write · --meet
Sets the event location and description text
Both are optional.
Write · --location / --description
Chooses the calendar by ID; the default is primary
Without it the event goes on your primary calendar.
Write · --calendar
The SKILL.md tells the agent to read gws-shared for sign-in, flags and security rules
Files · Read gws-shared first

From the official docs

Permissions

Medium risk

It creates real events on your Google Calendar, so a wrong date or attendee list ends up on your calendar. Check the title, times and attendees before you approve the command.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It creates real events on your calendar
SKILL.md marks it as a write command to confirm first. Read the exact title, times and time zone before you say yes.
Attendees are added from what you type
You can pass attendee emails, so check each address. A typo adds the wrong person to the event.
Needs a Google sign-in on this machine
Choose only the Calendar service when Google asks for access.

Technical details

Talks to	Google Workspace APIs, called by the gws CLI
Sign-in and keys	The gws CLI encrypts saved Google credentials (AES-256-GCM) with a key in your OS keyring, or in ~/.config/gws/.encryption_key when the file backend is set.
Scopes	Only the Google service this command touches, chosen when you run gws auth login

Questions

What does gws-calendar-insert do?

It creates a new Google Calendar event from the title, start and end time you give it. You can also add a location, a description, attendees and a Google Meet link.

How do I install gws-calendar-insert?

Use the install box above, which has tabs for Claude Code, Codex and the skills CLI. Each sets up the gws CLI, signs you in to Google, and installs this skill together with gws-shared, because SKILL.md tells the agent to read gws-shared first for sign-in, global flags and security rules. There is no Claude app upload tab: the skill runs a gws command, and the README documents installing gws as a binary, npm, cargo, Nix or Homebrew install on your own machine.

Does gws-calendar-insert need an API key?

SKILL.md names no API key. The gws CLI signs in with your Google account through OAuth, and the README says it needs a Google Cloud project for the OAuth credentials. A service account is the documented alternative for servers.

Is gws-calendar-insert safe to use?

SKILL.md marks it as a write command and says to confirm with you before it runs. It creates events with the details the agent passes, so read the title, times and attendees before you approve.

Is this an official Google skill?

It lives in the googleworkspace GitHub organization, but the README says gws is not an officially supported Google product and that the project is under active development with breaking changes expected before v1.0.

gws-calendar-insert vs gws-calendar?

gws-calendar-insert is the one helper for creating an event. The gws-calendar skill is the full command set: its SKILL.md lists this helper plus +agenda and the calendar API resources such as acl and calendarList.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-calendar-insert

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 7

googleworkspace/cli README · github.com
gws-shared SKILL.md · github.com
Codex skills docs · learn.chatgpt.com
skills CLI commands · github.com
gws-calendar-insert SKILL.md · github.com
gws-calendar-insert on skills.sh · skills.sh
gws-calendar SKILL.md · github.com