KosmoKrator

productivity

Google Calendar MCP Integration for Claude Code

Connect Google Calendar to Claude Code 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 Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

Google Calendar MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "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 Claude Code

Claude Code 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 Claude CodeClient-level gateway setup.