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.
7 functions 6 read 1 write Manual OAuth token auth
Google Calendar for agents
Credentials can be configured manually in web or CLI hosts.
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-calendar- package
google-calendar- auth_strategy
oauth2_manual_tokenManual OAuth token- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
true
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.gcalendar_list_events | Read read | 6 | 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 read | 2 | 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 write | 7 | 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 read | 1 | 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 read | 1 | 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 read | 0 | 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 read | 0 | Get the authenticated Google user's profile information, including name, email, and profile picture. Useful for verifying the connected account. |