Skip to content
Skillpedia
Email & messaging32k · #6252

gws-calendar-insert

Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.

What it does

This tool creates a new event in your Google Calendar. You provide the event's name, when it starts, and when it ends.

When to use it

  • ✓Schedule a meeting with colleagues.
  • ✓Set a reminder for a task.
  • ✓Book a time slot for an appointment.

Example of what to ask your AI

“Create an event called 'Team Meeting' for tomorrow at 10 AM, ending at 11 AM.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/googleworkspace/cli/blob/main/skills/gws-calendar-insert/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/googleworkspace/cli/blob/main/skills/gws-calendar-insert/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

You tell the AI the event's name, start time, and end time. The AI then adds this to your Google Calendar.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add googleworkspace/cli --skill gws-calendar-insert

Or download just the file:

curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-calendar-insert/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

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

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

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

FAQ

Can I add guests?

Yes, you can add the email addresses of people you want to invite to the event.

Can I add a location or description?

Yes, you can specify where the event will take place and add more details in the description.

Can I add a Google Meet link?

Yes, just ask to add a Google Meet link, and the AI will include one in your calendar event.

Details

Original description by the author

Google Calendar: Create a new event.

repo: googleworkspace/cli

Popularity

GitHub stars
32k
Ranking position
#6252
License
Apache-2.0
Updated
10/6/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills