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.

7 functions 6 read 1 write Manual OAuth token 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__gcalendar_list_events google-calendar.gcalendar_list_events Read 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.
integration__google_calendar__gcalendar_get_event google-calendar.gcalendar_get_event Read Get details of a specific event on a Google Calendar. Returns the full event resource including summary, description, attendees, and timing.
integration__google_calendar__gcalendar_create_event google-calendar.gcalendar_create_event Write Create a new event on a Google Calendar. Requires at minimum a summary, start time, and end time. Supports adding attendees, location, and description.
integration__google_calendar__gcalendar_list_calendars google-calendar.gcalendar_list_calendars Read List all calendars on the user's Google Calendar account. Returns calendar IDs, summaries, and metadata for each calendar.
integration__google_calendar__gcalendar_get_calendar google-calendar.gcalendar_get_calendar Read Get details of a specific Google Calendar by its ID. Returns the calendar resource including summary, description, time zone, and access settings.
integration__google_calendar__gcalendar_list_colors google-calendar.gcalendar_list_colors Read 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.
integration__google_calendar__gcalendar_get_current_user google-calendar.gcalendar_get_current_user Read Get the authenticated Google user's profile information, including name, email, and profile picture. Useful for verifying the connected account.

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.