Google Calendar integration tool. List upcoming events and create new events. OAuth2 authentication for direct Calendar API access. "calendar" "schedule" "google calendar" "event" "appointment"
Install
npx skillscat add xuiltul/animaworks/google-calendar-tool Install via the SkillsCat registry.
SKILL.md
Google Calendar Tool
External tool for Google Calendar event management via OAuth2 API access.
Invocation via use_tool
{"tool": "use_tool", "arguments": {"tool_name": "google_calendar", "action": "ACTION", "args": {...}}}Actions
list — List upcoming events
{"tool_name": "google_calendar", "action": "list", "args": {"max_results": 20, "days": 7, "calendar_id": "primary"}}| Parameter | Type | Default | Description |
|---|---|---|---|
| max_results | integer | 20 | Maximum events to return |
| days | integer | 7 | Number of days ahead to search |
| calendar_id | string | "primary" | Calendar ID |
add — Create new event
{"tool_name": "google_calendar", "action": "add", "args": {"summary": "Meeting", "start": "2026-03-04T10:00:00Z", "end": "2026-03-04T11:00:00Z", "description": "Weekly standup", "location": "Room A"}}| Parameter | Type | Required | Description |
|---|---|---|---|
| summary | string | Yes | Event title |
| start | string | Yes | Start time (ISO8601 or YYYY-MM-DD for all-day) |
| end | string | Yes | End time (ISO8601 or YYYY-MM-DD for all-day) |
| description | string | No | Event description |
| location | string | No | Event location |
| calendar_id | string | No | Calendar ID (default: primary) |
| attendees | array | No | List of attendee email addresses |
CLI Usage (S-mode)
animaworks-tool google_calendar list [-n 20] [-d 7] [--calendar-id primary]
animaworks-tool google_calendar add "Meeting" --start 2026-03-04T10:00:00Z --end 2026-03-04T11:00:00ZNotes
- OAuth2 authentication flow required on first use
- Place credentials.json at ~/.animaworks/credentials/google_calendar/
- For all-day events, use YYYY-MM-DD format for start/end