KosmoKrator

productivity

Google Calendar MCP Gateway for AI Agents

Expose Google Calendar tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

Google Calendar MCP Gateway

Expose Google Calendar to MCP clients with `kosmokrator mcp:serve --integration=google-calendar`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator 
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry 
kosmokrator mcp:gateway:install --integration=google-calendar --write=deny --json
MCP configuration 
{
  "mcpServers": {
    "kosmokrator-google-calendar": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=google-calendar",
        "--write=deny"
      ]
    }
  }
}
Serve manually 
kosmokrator mcp:serve --integration=google-calendar --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__google_calendar__google_calendar_settings_get google-calendar.google_calendar_settings_get Read read
integration__google_calendar__google_calendar_settings_list google-calendar.google_calendar_settings_list Read read
integration__google_calendar__google_calendar_settings_watch google-calendar.google_calendar_settings_watch Write write
integration__google_calendar__google_calendar_calendars_insert google-calendar.google_calendar_calendars_insert Write write
integration__google_calendar__google_calendar_calendars_get google-calendar.google_calendar_calendars_get Read read
integration__google_calendar__google_calendar_calendars_patch google-calendar.google_calendar_calendars_patch Write write
integration__google_calendar__google_calendar_calendars_update google-calendar.google_calendar_calendars_update Write write
integration__google_calendar__google_calendar_calendars_delete google-calendar.google_calendar_calendars_delete Write write
integration__google_calendar__google_calendar_calendars_clear google-calendar.google_calendar_calendars_clear Write write
integration__google_calendar__google_calendar_colors_get google-calendar.google_calendar_colors_get Read read
integration__google_calendar__google_calendar_calendar_list_get google-calendar.google_calendar_calendar_list_get Read read
integration__google_calendar__google_calendar_calendar_list_watch google-calendar.google_calendar_calendar_list_watch Write write
integration__google_calendar__google_calendar_calendar_list_insert google-calendar.google_calendar_calendar_list_insert Write write
integration__google_calendar__google_calendar_calendar_list_list google-calendar.google_calendar_calendar_list_list Read read
integration__google_calendar__google_calendar_calendar_list_delete google-calendar.google_calendar_calendar_list_delete Write write
integration__google_calendar__google_calendar_calendar_list_update google-calendar.google_calendar_calendar_list_update Write write
integration__google_calendar__google_calendar_calendar_list_patch google-calendar.google_calendar_calendar_list_patch Write write
integration__google_calendar__google_calendar_channels_stop google-calendar.google_calendar_channels_stop Write write
integration__google_calendar__google_calendar_events_move google-calendar.google_calendar_events_move Write write
integration__google_calendar__google_calendar_events_watch google-calendar.google_calendar_events_watch Write write
integration__google_calendar__google_calendar_events_delete google-calendar.google_calendar_events_delete Write write
integration__google_calendar__google_calendar_events_import google-calendar.google_calendar_events_import Write write
integration__google_calendar__google_calendar_events_insert google-calendar.google_calendar_events_insert Write write
integration__google_calendar__google_calendar_events_quick_add google-calendar.google_calendar_events_quick_add Write write
integration__google_calendar__google_calendar_events_get google-calendar.google_calendar_events_get Read read
integration__google_calendar__google_calendar_events_patch google-calendar.google_calendar_events_patch Write write
integration__google_calendar__google_calendar_events_instances google-calendar.google_calendar_events_instances Read read
integration__google_calendar__google_calendar_events_update google-calendar.google_calendar_events_update Write write
integration__google_calendar__google_calendar_events_list google-calendar.google_calendar_events_list Read read
integration__google_calendar__google_calendar_acl_delete google-calendar.google_calendar_acl_delete Write write
integration__google_calendar__google_calendar_acl_list google-calendar.google_calendar_acl_list Read read
integration__google_calendar__google_calendar_acl_patch google-calendar.google_calendar_acl_patch Write write
integration__google_calendar__google_calendar_acl_update google-calendar.google_calendar_acl_update Write write
integration__google_calendar__google_calendar_acl_get google-calendar.google_calendar_acl_get Read read
integration__google_calendar__google_calendar_acl_watch google-calendar.google_calendar_acl_watch Write write
integration__google_calendar__google_calendar_acl_insert google-calendar.google_calendar_acl_insert Write write
integration__google_calendar__google_calendar_freebusy_query google-calendar.google_calendar_freebusy_query Write write

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.