google-calendar-automation
Lightweight Google Calendar integration with standalone OAuth authentication. No MCP server required.
By sickn33 · 585 installs
npx skills add sickn33/agentic-awesome-skills --skill google-calendar-automation
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.
When to Use
You need to list, create, inspect, or update Google Calendar events from local scripts.
The task requires OAuth backed calendar automation without standing up an MCP server.
You need quick operational access to calendars, schedules, attendees, or event details in a Workspace environment.
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.
Limitations
Use this skill only when the task clearly matches the scope described above.
Do not treat the output as a substitute for environment specific validation, testing, or expert review.
Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.