Google Calendar Integration

Manage events, calendars, and schedule via Google Calendar API. Supports multiple Google accounts.

Commands

All commands: ~/.claude/skills/gcalendar/gcalendar <command>

Global Flags

Flag	Description
--account <name> or -a <name>	Select account (default: first configured)

Setup

Command	Description
accounts	List configured accounts
auth	Setup OAuth2 authentication
status	Check authentication status

Calendars

Command	Description
calendars	List all calendars
calendar [id]	Get calendar details (default: primary)

Events

Command	Description
events [flags]	List events
event <id>	Get event details
event-create <title> [flags]	Create event
event-delete <id>	Delete event
quick <text>	Quick add with natural language

Event list flags:

• --calendar <id> - Calendar ID (default: primary)
• --limit <n> - Max results (default: 10)
• --from <datetime> - Start time (ISO format)
• --to <datetime> - End time (ISO format)
• --today - Show today's events
• --week - Show next 7 days
• --query <text> - Search in events

Event create flags:

• --calendar <id> - Calendar ID
• --date <YYYY-MM-DD> - All-day event
• --start <HH:MM> - Start time
• --end <HH:MM> - End time
• --start-date <YYYY-MM-DD> - Start date (multi-day)
• --end-date <YYYY-MM-DD> - End date
• --description <text> - Description
• --location <text> - Location

Examples

# List configured accounts
~/.claude/skills/gcalendar/gcalendar accounts

# Authenticate a specific account
~/.claude/skills/gcalendar/gcalendar auth --account work

# List today's events (default account)
~/.claude/skills/gcalendar/gcalendar events --today

# List events from specific account
~/.claude/skills/gcalendar/gcalendar --account work events --today
~/.claude/skills/gcalendar/gcalendar --account personal events --week

# Search events
~/.claude/skills/gcalendar/gcalendar events --query "meeting"

# Create all-day event
~/.claude/skills/gcalendar/gcalendar event-create "Vacation" --date 2026-02-15

# Create timed event
~/.claude/skills/gcalendar/gcalendar event-create "Call with client" --start 14:00 --end 15:00

# Quick add (natural language)
~/.claude/skills/gcalendar/gcalendar quick "Lunch with John tomorrow at noon"

# Delete event
~/.claude/skills/gcalendar/gcalendar event-delete <event-id>

When to Use

Activate this skill when user:

• Asks about their calendar or schedule
• Wants to see upcoming events or meetings
• Needs to create, modify, or delete events
• Asks "what do I have today/tomorrow/this week"
• Wants to schedule something
• Mentions a specific Google account (work, personal, etc.)