Google Calendar

A straightforward Google Calendar integration that handles the usual suspects: viewing events, creating and updating meetings, finding free time slots, and managing invitations. The standout feature is the built-in OAuth flow that stores tokens in your system keyring, so you're not fumbling with credentials or spinning up a separate MCP server. Note that it requires a Google Workspace account, not a personal Gmail. The find-free-time command is handy for scheduling across multiple attendees. If you need calendar automation without the overhead of a full workspace integration, this gets the job done cleanly.

skills.sh installs: 544
GitHub stars: 454
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add sanjay3290/ai-skills --skill google-calendar --agent claude-code

Installs into .claude/skills of the current project.

Files

Google Calendar

Lightweight Google Calendar integration with standalone OAuth authentication. No MCP server required.

⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.

First-Time Setup

Authenticate with Google (opens browser):

python scripts/auth.py login

Check authentication status:

python scripts/auth.py status

Logout when needed:

python scripts/auth.py logout

Commands

All operations via scripts/gcal.py. Auto-authenticates on first use if not logged in.

List Calendars

python scripts/gcal.py list-calendars

List Events

# List events from primary calendar (default: next 30 days)
python scripts/gcal.py list-events

# List events with specific time range
python scripts/gcal.py list-events --time-min 2024-01-15T00:00:00Z --time-max 2024-01-31T23:59:59Z

# List events from a specific calendar
python scripts/gcal.py list-events --calendar "work@example.com"

# Limit results
python scripts/gcal.py list-events --max-results 10

SKILL.md on GitHub