Can I use Cal.com as a CLI?

Yes. KosmoKrator exposes a Cal.com CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Cal.com through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Cal.com tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Cal.com credentials stored?

Cal.com credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Cal.com MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

scheduling

Cal.com CLI for AI Agents

Use the Cal.com CLI from KosmoKrator to call Cal.com tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

6 functions 5 read 1 write Bearer token auth

Submit Cal.com feedback View package source

Cal.com CLI Setup

Cal.com can be configured headlessly with `kosmokrator integrations:configure cal`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure cal --set access_token="$CAL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor cal --json
kosmokrator integrations:status --json

Credentials

Authentication type: Bearer token bearer_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`CAL_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`CAL_URL`	URL `url`	no	API Base URL

Call Cal.com Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call cal.cal_list_event_types '{
  "limit": 1,
  "page": 1,
  "teamId": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:cal cal_list_event_types '{
  "limit": 1,
  "page": 1,
  "teamId": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs cal --json
kosmo integrations:docs cal.cal_list_event_types --json
kosmo integrations:schema cal.cal_list_event_types --json
kosmo integrations:search "Cal.com" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Cal.com.

`cal.cal_list_event_types`

Read read

List available event types (booking link templates) from Cal.com. Supports filtering by team and pagination.

Parameters: limit, page, teamId

Generic CLI call

kosmo integrations:call cal.cal_list_event_types '{"limit":1,"page":1,"teamId":1}' --json

Provider shortcut

kosmo integrations:cal cal_list_event_types '{"limit":1,"page":1,"teamId":1}' --json

`cal.cal_get_event_type`

Read read

Get detailed information about a specific event type from Cal.com by its ID.

Parameters: id

Generic CLI call

kosmo integrations:call cal.cal_get_event_type '{"id":1}' --json

Provider shortcut

kosmo integrations:cal cal_get_event_type '{"id":1}' --json

`cal.cal_list_bookings`

Read read

List bookings from Cal.com with optional filtering by status, event type, and pagination.

Parameters: limit, page, status, eventTypeId

Generic CLI call

kosmo integrations:call cal.cal_list_bookings '{"limit":1,"page":1,"status":"example_status","eventTypeId":1}' --json

Provider shortcut

kosmo integrations:cal cal_list_bookings '{"limit":1,"page":1,"status":"example_status","eventTypeId":1}' --json

`cal.cal_get_booking`

Read read

Get detailed information about a specific booking from Cal.com by its ID.

Parameters: id

Generic CLI call

kosmo integrations:call cal.cal_get_booking '{"id":1}' --json

Provider shortcut

kosmo integrations:cal cal_get_booking '{"id":1}' --json

`cal.cal_create_booking`

Write write

Create a new booking in Cal.com for a specific event type. Provide the event type, start/end times, and attendee information.

Parameters: eventTypeId, start, end, responses

Generic CLI call

kosmo integrations:call cal.cal_create_booking '{"eventTypeId":1,"start":"example_start","end":"example_end","responses":"example_responses"}' --json

Provider shortcut

kosmo integrations:cal cal_create_booking '{"eventTypeId":1,"start":"example_start","end":"example_end","responses":"example_responses"}' --json

`cal.cal_get_current_user`

Read read

Get the authenticated Cal.com user's profile information, including name, email, and time zone.

Parameters: none

Generic CLI call

kosmo integrations:call cal.cal_get_current_user '{}' --json

Provider shortcut

kosmo integrations:cal cal_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`cal.cal_list_event_types`

List available event types (booking link templates) from Cal.com. Supports filtering by team and pagination.

Operation: Read read
Schema command: kosmo integrations:schema cal.cal_list_event_types --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of event types to return per page.
`page`	integer	no	Page number for pagination (starts at 1).
`teamId`	integer	no	Filter event types belonging to a specific team by its ID.

`cal.cal_get_event_type`

Get detailed information about a specific event type from Cal.com by its ID.

Operation: Read read
Schema command: kosmo integrations:schema cal.cal_get_event_type --json

Parameter	Type	Required	Description
`id`	integer	yes	The event type ID.

`cal.cal_list_bookings`

List bookings from Cal.com with optional filtering by status, event type, and pagination.

Operation: Read read
Schema command: kosmo integrations:schema cal.cal_list_bookings --json

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of bookings to return per page.
`page`	integer	no	Page number for pagination (starts at 1).
`status`	string	no	Filter by booking status: "confirmed", "pending", "cancelled", or "rejected".
`eventTypeId`	integer	no	Filter bookings for a specific event type by its ID.

`cal.cal_get_booking`

Get detailed information about a specific booking from Cal.com by its ID.

Operation: Read read
Schema command: kosmo integrations:schema cal.cal_get_booking --json

Parameter	Type	Required	Description
`id`	integer	yes	The booking ID.

`cal.cal_create_booking`

Create a new booking in Cal.com for a specific event type. Provide the event type, start/end times, and attendee information.

Operation: Write write
Schema command: kosmo integrations:schema cal.cal_create_booking --json

Parameter	Type	Required	Description
`eventTypeId`	integer	yes	The event type ID to book.
`start`	string	yes	Start time in ISO 8601 format (e.g., "2026-04-10T09:00:00Z").
`end`	string	yes	End time in ISO 8601 format (e.g., "2026-04-10T09:30:00Z").
`responses`	object	yes	Attendee responses. Must include "name" and "email". Example: {"name": "John Doe", "email": "[email protected]", "notes": "Optional notes."}.

`cal.cal_get_current_user`

Get the authenticated Cal.com user's profile information, including name, email, and time zone.

Operation: Read read
Schema command: kosmo integrations:schema cal.cal_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.