google-calendar-tool
Google Calendar integration tool for listing and creating events via OAuth2 Calendar API access. Use when: checking upcoming events, creating appointments, or updating your schedule.
Install
npx skillscat add xuiltul/animaworks/google-calendar-tool Install via the SkillsCat registry.
The Google Calendar tool lets an agent list upcoming events and create or update calendar entries through the Calendar API using OAuth2 authentication. It solves the need to check schedules or add appointments without manual interface use. Agents or developers should use it when they need programmatic access to calendar data or event creation.
Google Calendar Tool
External tool for Google Calendar event management via OAuth2 API access.
Invocation via Bash
Use Bash with animaworks-tool google_calendar <subcommand> [args]. See Actions below for syntax.
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/C/D/G-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
Install
npx skillscat add xuiltul/animaworks/google-calendar-tool Install via the SkillsCat registry.