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

{
  "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:

# 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

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 + Apify Actors.