productivity
Google Calendar MCP, CLI, and Lua Integration for AI Agents
Google Calendar integration docs for AI agents: MCP gateway setup, Google Calendar CLI commands, Lua API reference, credentials, and function schemas.
8 functions 5 read 3 write OAuth browser flow auth
Google Calendar for agents
OAuth can be configured in web hosts through redirect and in CLI hosts through local/device authorization; runtime works with stored tokens.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
google_calendar- route_slug
google/google-calendar- package
google- auth_strategy
oauth2_authorization_codeOAuth browser flow- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
false
Quick Links
Lua APIAgent-facing namespace and function reference. Google Calendar CLIHeadless setup and direct function calls. Google Calendar MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
Google Calendar MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Google Calendar.
Claude Code Google Calendar MCP setup for Claude Code. Cursor Google Calendar MCP setup for Cursor. Codex Google Calendar MCP setup for Codex. OpenAI Agents Google Calendar MCP setup for OpenAI Agents SDK. Claude Agent SDK Google Calendar MCP setup for Claude Agent SDK. Vercel AI SDK Google Calendar MCP setup for Vercel AI SDK. LangChain Google Calendar MCP setup for LangChain. LangGraph Google Calendar MCP setup for LangGraph. CrewAI Google Calendar MCP setup for CrewAI. MCP clients Google Calendar MCP setup for Generic MCP Clients.
Google Calendar CLI Matrix
Use these pages for direct Google Calendar CLI workflows in scripts, CI, cron, and agent wrappers.
CI Google Calendar CLI for CI. Cron Jobs Google Calendar CLI for cron jobs. Shell Scripts Google Calendar CLI for shell scripts. Headless Automation Google Calendar CLI for headless automation. Coding Agents Google Calendar CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
google_calendar.google_calendar_create_event | Write write | 11 | Create a Google Calendar event. Use startDateTime/endDateTime for timed events, or startDate/endDate for all-day events. |
google_calendar.google_calendar_delete_event | Write write | 2 | Delete a Google Calendar event by its ID. |
google_calendar.google_calendar_freebusy | Read read | 3 | Check free/busy availability across one or more Google Calendars. Returns busy time slots within the specified time range. Useful for finding open slots for scheduling meetings. |
google_calendar.google_calendar_get_event | Read read | 2 | Get a single Google Calendar event by its ID. |
google_calendar.google_calendar_list_calendars | Read read | 2 | List all Google Calendars the user has access to. |
google_calendar.google_calendar_list_events | Read read | 6 | List or search events in a Google Calendar. Supports date range filtering and text search. |
google_calendar.google_calendar_quick_add | Read read | 2 | Create a Google Calendar event from natural language text (e.g., "Lunch with Alice tomorrow at noon"). |
google_calendar.google_calendar_update_event | Write write | 12 | Update an existing Google Calendar event (partial update). Only specified fields are changed. |