personal-calendar

Manage Google Calendar events, availability, and meeting creation via command line.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/cosmicdreams/claude-plugins --skill personal-calendar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: personal-calendar
Source: https://github.com/cosmicdreams/claude-plugins/tree/main/workflow/skills/personal-calendar
Command: npx skills add https://github.com/cosmicdreams/claude-plugins --skill personal-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gws, node, @googleworkspace/cli, and includes references (resource) components.

What problem does it solve?

It helps you quickly understand what’s happening on your calendar, find open time, and schedule new meetings without manually browsing through Google Calendar.

Core Features & Use Cases

  • List upcoming events: Produces a time-sorted view grouped by day, including bold event titles and durations—useful for “what do I have today/this week?” checks.
  • Check free/busy windows: Determines when you’re available by inverting busy blocks—useful for conflict detection and availability planning.
  • Create calendar events: Inserts new meetings after confirming key details (title, date, start/end time, attendees), with ISO 8601 time conversion—useful for scheduling and blocking time.

Quick Start

Ask: “What meetings do I have this week, and am I free on Thursday afternoon?” and review the grouped schedule plus any free windows.

Frequently Asked Questions about personal-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my Google Calendar availability and upcoming meetings from the command line?

Check your Google Calendar availability by retrieving a time-sorted, day-grouped view of upcoming meetings and inverting busy blocks to find free windows directly from the command line. This provides a quick overview of your schedule and open slots without manual browsing.

Can I create a new Google Calendar event using the gws CLI?

Yes, you can create a new Google Calendar event using the gws CLI. The process prompts for key details like the event title, date, start and end times, and attendees, then requires your confirmation before inserting the meeting with proper ISO 8601 datetime conversion.

Do I need to install anything specific to manage my Google Calendar events this way?

You need the gws CLI, Node environment, and the @googleworkspace/cli package installed to manage your Google Calendar events. The system performs preflight integration checks to ensure your environment is properly configured before attempting any calendar operations.

What's the best way to find open time slots for scheduling on my primary calendar?

The best way to find open time slots is by running a free/busy query that inverts your existing busy blocks. This conflict check identifies available windows on your primary calendar, making it useful for availability planning and avoiding double-booking when scheduling new events.

How does the command line handle datetime formatting when scheduling a new meeting?

When scheduling a new meeting, the command line requires ISO 8601 datetime formatting for start and end times. The system handles the time conversion automatically after you confirm the event details, ensuring the calendar event is inserted with the correct timezone-independent format.