productivity
Google Calendar CLI for Headless Automation
Use the Google Calendar CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Manual OAuth token auth
Google Calendar CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Google Calendar CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Google Calendar CLI for Headless Automation
kosmokrator integrations:configure google-calendar --set access_token="$GOOGLE_CALENDAR_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call google-calendar.gcalendar_list_events '{"calendar_id":"example_calendar_id","timeMin":"example_timeMin","timeMax":"example_timeMax","maxResults":1,"q":"example_q","orderBy":"example_orderBy"}' --json Discovery Before Execution
Agents and scripts can inspect Google Calendar docs and schemas before choosing a function.
kosmo integrations:docs google-calendar --json
kosmo integrations:docs google-calendar.gcalendar_list_events --json
kosmo integrations:schema google-calendar.gcalendar_list_events --json
kosmo integrations:search "Google Calendar" --json
kosmo integrations:list --json Useful Google Calendar CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
google-calendar.gcalendar_list_events | Read | calendar_id, timeMin, timeMax, maxResults, q, orderBy | List events on a Google Calendar. Returns events within a specified time range. Use "primary" as the calendar ID for the user's main calendar. |
google-calendar.gcalendar_get_event | Read | calendar_id, event_id | Get details of a specific event on a Google Calendar. Returns the full event resource including summary, description, attendees, and timing. |
google-calendar.gcalendar_create_event | Write | calendar_id, summary, start, end, description, attendees, location | Create a new event on a Google Calendar. Requires at minimum a summary, start time, and end time. Supports adding attendees, location, and description. |
google-calendar.gcalendar_list_calendars | Read | maxResults | List all calendars on the user's Google Calendar account. Returns calendar IDs, summaries, and metadata for each calendar. |
google-calendar.gcalendar_get_calendar | Read | calendar_id | Get details of a specific Google Calendar by its ID. Returns the calendar resource including summary, description, time zone, and access settings. |
google-calendar.gcalendar_list_colors | Read | none | Get the available color definitions for Google Calendar events and calendars. Returns color palettes that can be used when creating or updating events and calendars. |
google-calendar.gcalendar_get_current_user | Read | none | Get the authenticated Google user's profile information, including name, email, and profile picture. Useful for verifying the connected account. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.