KosmoKrator

productivity

Google Calendar MCP Integration for OpenAI Agents SDK

Connect Google Calendar to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

8 functions 5 read 3 write OAuth browser flow auth
Submit Google Calendar feedback View package source

Connect Google Calendar to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Google Calendar MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-google_calendar": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=google_calendar",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=google_calendar --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Google Calendar instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Google Calendar Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Google Calendar integration catalog.

MCP toolSource functionTypeDescription
integration__google_calendar__google_calendar_create_event google_calendar.google_calendar_create_event Write Create a Google Calendar event. Use startDateTime/endDateTime for timed events, or startDate/endDate for all-day events.
integration__google_calendar__google_calendar_delete_event google_calendar.google_calendar_delete_event Write Delete a Google Calendar event by its ID.
integration__google_calendar__google_calendar_freebusy google_calendar.google_calendar_freebusy Read 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.
integration__google_calendar__google_calendar_get_event google_calendar.google_calendar_get_event Read Get a single Google Calendar event by its ID.
integration__google_calendar__google_calendar_list_calendars google_calendar.google_calendar_list_calendars Read List all Google Calendars the user has access to.
integration__google_calendar__google_calendar_list_events google_calendar.google_calendar_list_events Read List or search events in a Google Calendar. Supports date range filtering and text search.
integration__google_calendar__google_calendar_quick_add google_calendar.google_calendar_quick_add Read Create a Google Calendar event from natural language text (e.g., "Lunch with Alice tomorrow at noon").
integration__google_calendar__google_calendar_update_event google_calendar.google_calendar_update_event Write Update an existing Google Calendar event (partial update). Only specified fields are changed.

Related Google Calendar Pages

Google Calendar CLIUse direct JSON commands instead of MCP discovery. Google Calendar MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.