google-calendar
Interact with Google Calendar - list calendars, view events, create/update/delete events, and find free time. Use when user asks to: check calendar, schedule a meeting, create an event, find available time, list upcoming events, delete or update a calendar event, or respond to meeting invitations. L
By sanjay3290 · 509 installs
npx skills add sanjay3290/ai-skills --skill google-calendar
Source repository · Upstream listing
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):
Check authentication status:
Logout when needed:
Commands
All operations via scripts/gcal.py . Auto authenticates on first use if not logged in.
List Calendars
List Events
Get Event Details
Create Event
Update Event
Delete Event
Find Free Time
Find the first available slot for a meeting with specified attendees:
Respond to Event Invitation
Date/Time Format
All times use ISO 8601 format with timezone:
UTC: 2024 01 15T10:30:00Z
With offset: 2024 01 15T10:30:00 05:00 (EST)
Calendar ID Format
Primary calendar: Use primary or omit the calendar flag
Other calendars: Use the calendar ID from list calendars (usually an email address)
Token Management
Tokens stored securely using the system keyring:
macOS : Keychain
Windows : Windows Credential Locker
Linux : Secret Service API (GNOME Keyring, KDE Wallet, etc.)
Service name: google calendar skill oauth
Tokens are automatically refreshed when expired using Google's cloud function.