# Cal.com MCP - AI Scheduling Agent Tools (`red.cars/cal-com-mcp`) Actor 319 tools for AI agents that automate Cal.com scheduling, bookings, events, and analytics. Wraps the Cal.com PP CLI as an MCP server with PPE billing. - **URL**: https://apify.com/red.cars/cal-com-mcp.md - **Developed by:** [AutomateLab](https://apify.com/red.cars) (community) - **Categories:** MCP servers, AI - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 result items This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Cal.com MCP Actor **319 tools for AI scheduling agents.** PPE-enabled Apify Actor that wraps the `cal-com-pp-mcp` binary as a standby MCP server. ### What It Does Wraps Cal.com's Printing Press CLI (`cal-com-pp-mcp`) as an Apify standby MCP actor. AI agents can call 319 tools for booking management, event types, scheduling, analytics, teams, organizations, webhooks, and workflows. ```` MCP Client → Apify Standby → cal-com-pp-mcp → Cal.com API ```` ### Why Use It - **Offline agenda store**: Sync bookings to local SQLite, query without API calls - **Full Cal.com coverage**: 319 tools across bookings, events, schedules, analytics, teams, orgs - **PPE billing**: Pay-per-event pricing via Apify (`$0.03–$0.09` per tool) - **AI agent ready**: MCP protocol compatible with Claude, GPT-4, and other LLM agents - **Humanized output**: `--json --compact --no-input --yes` flags for agent Pipelines ### MCP Client Integration ```json { "mcpServers": { "cal-com": { "command": "npx", "args": ["-y", "@apify/mcp"], "env": { "APIFY_API_KEY": "your-apify-api-key", "APIFY_ACTOR_ID": "your-cal-com-mcp-actor-id" } } } } ```` For manual testing via curl: ```bash ## Initialize echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \ | APIFY_API_KEY=your-key CALCOM_API_KEY=your-cal-key npx -y @apify/mcp ## List tools echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | APIFY_API_KEY=... npx -y @apify/mcp ``` ### MCP Tools Reference | Tool | Description | PPE Price | |------|-------------|-----------| | `bookings_get` | Get bookings (upcoming, past, cancelled) | $0.09 | | `bookings_create` | Create a new booking | $0.09 | | `bookings_cancel_bookings-booking` | Cancel a booking | $0.09 | | `bookings_confirm_bookings-booking` | Confirm a pending booking | $0.09 | | `bookings_reschedule_bookings-booking` | Reschedule a booking | $0.09 | | `event-types_get` | List event types | $0.06 | | `event-types_create` | Create an event type | $0.09 | | `event-types_update` | Update an event type | $0.09 | | `schedules_get` | Get schedules | $0.06 | | `schedules_create` | Create a schedule | $0.09 | | `schedules_update` | Update a schedule | $0.09 | | `slots_find` | Find available slots | $0.05 | | `slots_get-available` | Get available time slots | $0.05 | | `teams_get` | Get team info | $0.04 | | `teams_create` | Create a team | $0.09 | | `teams_event-types_teams-get-team` | Get team event types | $0.06 | | `organizations_organizations_get` | Get organization | $0.04 | | `organizations_organizations_create` | Create organization | $0.09 | | `analytics_bookings` | Booking analytics | $0.09 | | `analytics_density` | Slot density analytics | $0.05 | | `workload` | User workload report | $0.05 | | `webhooks_create` | Create webhook | $0.09 | | `webhooks_get` | Get webhooks | $0.08 | | `workflow_status` | Workflow status | $0.08 | | `agenda` | Read agenda from offline store | $0.04 | | `sync` | Sync to offline SQLite store | $0.09 | | `me_get` | Get current user profile | $0.04 | | `me_update` | Update current user | $0.09 | ### Pricing **Pay-Per-Event (PPE)** via Apify. Tool prices by category: | Category | Price | Tools | |----------|-------|-------| | Read / Query | $0.03–$0.04 | 127 tools | | Availability / Slots | $0.05 | 9 tools | | Booking / Scheduling | $0.06–$0.08 | 25 tools | | Write / Create / Update | $0.08–$0.09 | 152 tools | | Webhooks / Workflows | $0.08 | 6 tools | **Minimum spend**: $0.03 per tool call. No monthly minimum. ### vs Native Cal.com API | Feature | Cal.com MCP Actor | Native Cal.com API | |---------|-------------------|-------------------| | Tools | 319 | ~50 REST endpoints | | Offline store | SQLite sync | None | | PPE billing | Yes ($0.03–$0.09) | API costs + infrastructure | | MCP protocol | Native | Requires custom client | | Scheduling logic | Built-in slot finding | Manual implementation | | Auth | API key | OAuth 2.0 | | Rate limiting | Handled by actor | Your problem | ### Authentication Requires two secrets: 1. **APIFY\_API\_KEY** — Apify account token (for PPE billing) 2. **CALCOM\_API\_KEY** — Cal.com API key (for data access) Get Cal.com API key: `https://app.cal.com/settings/developer/api-keys` ### Local Development ```bash cd /home/seed/Projects/apify-actors/cal-com-mcp ## Install dependencies npm install ## Build TypeScript npm run build ## Test locally (requires CALCOM_API_KEY) echo '{"tool":"me_get","args":{}}' | CALCOM_API_KEY=your-key npx tsx src/main.ts ``` ### GitHub Topics `cal-com` `mcp` `mcp-server` `scheduling` `ai-agents` `apify` `booking` `calendar` ### Support - **Issues**: https://github.com/red-cars-io/cal-com-mcp/issues - **Apify Actor**: https://apify.com/cal-com-mcp - **Cal.com Docs**: https://docs.cal.com/ *** Built with [Printing Press](https://github.com/mvanhorn/printing-press-library) + [Apify Actors](https://apify.com/actors). # Actor input Schema ## `tool` (type: `string`): Cal.com tool to call (e.g. bookings\_get, event-types\_get, schedules\_create) ## `args` (type: `object`): Tool arguments as key-value pairs ## Actor input object example ```json { "tool": "bookings_get", "args": { "status": "upcoming", "limit": 10 } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "tool": "bookings_get", "args": {} }; // Run the Actor and wait for it to finish const run = await client.actor("red.cars/cal-com-mcp").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "tool": "bookings_get", "args": {}, } # Run the Actor and wait for it to finish run = client.actor("red.cars/cal-com-mcp").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "tool": "bookings_get", "args": {} }' | apify call red.cars/cal-com-mcp --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=red.cars/cal-com-mcp", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cal.com MCP - AI Scheduling Agent Tools", "description": "319 tools for AI agents that automate Cal.com scheduling, bookings, events, and analytics. Wraps the Cal.com PP CLI as an MCP server with PPE billing.", "version": "1.0", "x-build-id": "Zvd1StPOOY4xzOA0I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/red.cars~cal-com-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-red.cars-cal-com-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/red.cars~cal-com-mcp/runs": { "post": { "operationId": "runs-sync-red.cars-cal-com-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/red.cars~cal-com-mcp/run-sync": { "post": { "operationId": "run-sync-red.cars-cal-com-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "tool" ], "properties": { "tool": { "title": "Cal.com Tool", "type": "string", "description": "Cal.com tool to call (e.g. bookings_get, event-types_get, schedules_create)", "default": "bookings_get" }, "args": { "title": "Tool Arguments", "type": "object", "description": "Tool arguments as key-value pairs", "default": {} } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```