GWS Calendar Instant

Instant calendar event creation and management for quick scheduling from the command line.

When to Use This Command

Run this command when you need to:

• Create a calendar event instantly with minimal configuration using smart defaults
• Quickly block time on your calendar for focus work, reminders, or personal tasks
• Manage today's or this week's calendar events with rapid list and update operations

Consider alternatives when:

• You need to coordinate complex multi-attendee scheduling with availability checking
• You are managing calendar resources or room bookings which need the full calendar command

Quick Start

Configuration

Copy
name: gws-calendar-instant
type: command
category: google-workspace

Example Invocation

Copy
claude command:run gws-calendar-instant --title "Sprint Planning" --when "tomorrow 10am" --duration 45

Example Output

Creating calendar event...
  Title: Sprint Planning
  When: Tue Mar 16, 2026 10:00 AM
  Duration: 45 minutes
  Calendar: primary

Event created successfully.
  Event ID: evt_8f3a2b1c
  Link: https://calendar.google.com/event?eid=8f3a2b1c

Today's remaining events:
  2:00 PM - 2:30 PM  Team Standup
  4:00 PM - 5:00 PM  Code Review Session

Core Concepts

Instant Scheduling Overview

Aspect	Details
Smart Parsing	Natural language time parsing: "tomorrow 3pm", "next Monday", "in 2 hours"
Quick Create	Minimal required fields: just title and time, everything else uses defaults
Day View	Automatically shows remaining events for context after creating
Time Blocks	Shorthand for focus time, lunch, OOO with pre-configured settings
Conflict Check	Warns if the new event overlaps with an existing event on your calendar

Instant Create Workflow

Parse Natural Language Time
         |
         v
Check for Conflicts
  |              |
  v              v
No conflict    Conflict found
  |              |
  v              v
Create event   Warn + confirm
  |              |
  v              v
Show day view  Suggest alt time

Configuration

Parameter	Type	Default	Description
title	string	(required)	Event title or description
when	string	(required)	Natural language time: "today 3pm", "next Friday 9am"
duration	integer	30	Event duration in minutes
type	string	event	Event type: event, focus, ooo, reminder
attendees	string	(none)	Comma-separated email addresses to invite

Best Practices

1. Use natural language confidently - The parser handles most common formats including relative times like "in 2 hours", day names like "next Wednesday", and specific dates with times.

2. Block focus time proactively - Use the focus event type to block deep work sessions on your calendar. These show as busy to others and prevent meeting invitations during those periods.

3. Review the day view after creating - The automatic day view output helps you spot scheduling issues immediately rather than discovering conflicts later when it is too late to adjust.

4. Set meaningful durations - The default 30 minutes works for quick syncs but deliberately set longer durations for complex meetings. Rushed meetings waste more time than slightly long ones.

Common Issues

1. Ambiguous time parsing - "Next Friday" can be interpreted differently depending on the current day. The command shows the parsed date for confirmation, review it before proceeding.

2. Event created on wrong calendar - If you have multiple calendars, the default is primary. Specify the calendar parameter to target a specific work or personal calendar.

3. Duration extends past business hours - Creating a 2-hour event at 5pm schedules it through 7pm. The command warns about this but does not prevent it since some teams work varied hours across different time zones.

4. Conflict detection misses all-day events - The conflict checker focuses on timed events and may not flag overlaps with all-day events like out-of-office blocks. Check your calendar manually for all-day events that might affect availability during the time slot you are booking.

5. Reminder notification not received - Calendar reminders depend on your notification settings in Gmail and the Calendar app. Verify that notifications are enabled both in the Calendar settings and your device notification preferences to ensure reminders are delivered.