scheduling-events

Schedule and manage Google Calendar events using gcallm CLI.

⭐5stars🔀0forks📁View on GitHub🕐Updated Dec 3, 2025⬇️2downloads

When & Why to Use This Skill

This Claude skill provides a powerful interface for Google Calendar management via the gcallm CLI. It streamlines the process of scheduling, querying, and organizing events by leveraging natural language processing, file-based inputs, and screenshot recognition, significantly reducing the friction of manual calendar maintenance and improving workflow efficiency.

Use Cases

  • Natural Language Scheduling: Instantly create calendar events using flexible, human-like commands such as 'Meeting with Sarah tomorrow at 3pm'.
  • Bulk Event Import: Automate the addition of multiple appointments by piping text files or system outputs directly into the calendar tool.
  • Visual Event Extraction: Capture event details from screenshots of flyers, emails, or digital invitations and automatically sync them to your schedule.
  • Conversational Agenda Queries: Check your daily schedule or verify availability through simple natural language questions like 'When is my next meeting?'.
  • Clipboard Integration: Quickly add events copied from other applications without manual typing by utilizing the CLI's clipboard support.
name"Scheduling Events"
description"Schedule and manage Google Calendar events using gcallm CLI."

Scheduling Events with gcallm

# 1. Write event details to /tmp/gcal/events.txt
# 2. Pipe to gcallm
cat /tmp/gcal/events.txt | gcallm

Basic Usage

# Direct text input
gcallm "Meeting with Sarah tomorrow at 3pm"
gcallm "Lunch next Tuesday 12-1pm at Cafe Nero"

# Multiple events at once
gcallm "Team standup Mon-Fri 9:30am, Coffee with Alex Thursday 2pm"

Input from Files (Stdin)

# Pipe from file
cat /tmp/gcal/events.txt | gcallm
cat schedule.txt | gcallm

# Echo to stdin
echo "Doctor appointment Friday 10am" | gcallm

Other Input Modes

# From clipboard
gcallm  # Uses clipboard if no stdin provided

# From screenshots (latest screenshot on Desktop)
gcallm -s "Add events from this screenshot"
gcallm --screenshots 2 "Add from last 2 screenshots"

Ask Questions

# General calendar questions
gcallm ask "What's on my calendar today?"
gcallm ask "When is my next meeting?"
gcallm ask "Am I free Thursday afternoon?"

Key Patterns

  1. Stdin-first: Prefer cat file | gcallm for non-interactive workflows
  2. Natural language: gcallm understands flexible date/time formats
  3. Multiple events: Separate with commas or natural language
  4. Today's date: gcallm automatically knows current date/time