Cal.com Automation via Rube MCP
Automate Cal.com scheduling operations through Composio's Cal toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Cal.com connection via
RUBE_MANAGE_CONNECTIONS with toolkit cal
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit cal
- If connection is not ACTIVE, follow the returned auth link to complete Cal.com authentication
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Manage Bookings
When to use: User wants to list, create, or review bookings
Tool sequence:
CAL_FETCH_ALL_BOOKINGS - List all bookings with filters [Required]
CAL_POST_NEW_BOOKING_REQUEST - Create a new booking [Optional]
Key parameters for listing:
status: Filter by booking status ('upcoming', 'recurring', 'past', 'cancelled', 'unconfirmed')
afterStart: Filter bookings after this date (ISO 8601)
beforeEnd: Filter bookings before this date (ISO 8601)
Key parameters for creation:
eventTypeId: Event type ID for the booking
start: Booking start time (ISO 8601)
end: Booking end time (ISO 8601)
name: Attendee name
email: Attendee email
timeZone: Attendee timezone (IANA format)
language: Attendee language code
metadata: Additional metadata object
Pitfalls:
- Date filters use ISO 8601 format with timezone (e.g., '2024-01-15T09:00:00Z')
eventTypeId must reference a valid, active event type
- Booking creation requires matching an available slot; check availability first
- Time zone must be a valid IANA timezone string (e.g., 'America/New_York')
- Status filter values are specific strings; invalid values return empty results
2. Check Availability
When to use: User wants to find free/busy times or available booking slots
Tool sequence:
CAL_RETRIEVE_CALENDAR_BUSY_TIMES - Get busy time blocks [Required]
CAL_GET_AVAILABLE_SLOTS_INFO - Get specific available slots [Required]
Key parameters:
dateFrom: Start date for availability check (YYYY-MM-DD)
dateTo: End date for availability check (YYYY-MM-DD)
eventTypeId: Event type to check slots for
timeZone: Timezone for the availability response
loggedInUsersTz: Timezone of the requesting user
Pitfalls:
- Busy times show when the user is NOT available
- Available slots are specific to an event type's duration and configuration
- Date range should be reasonable (not months in advance) to get accurate results
- Timezone affects how slots are displayed; always specify explicitly
- Availability reflects calendar integrations (Google Calendar, Outlook, etc.)
3. Configure Webhooks
When to use: User wants to set up or manage webhook notifications for booking events
Tool sequence:
CAL_RETRIEVE_WEBHOOKS_LIST - List existing webhooks [Required]
CAL_GET_WEBHOOK_BY_ID - Get specific webhook details [Optional]
CAL_UPDATE_WEBHOOK_BY_ID - Update webhook configuration [Optional]
CAL_DELETE_WEBHOOK_BY_ID - Remove a webhook [Optional]
Key parameters:
id: Webhook ID for GET/UPDATE/DELETE operations
subscriberUrl: Webhook endpoint URL
eventTriggers: Array of event types to trigger on
active: Whether the webhook is active
secret: Webhook signing secret
Pitfalls:
- Webhook URLs must be publicly accessible HTTPS endpoints
- Event triggers include: 'BOOKING_CREATED', 'BOOKING_RESCHEDULED', 'BOOKING_CANCELLED', etc.
- Inactive webhooks do not fire; toggle
active to enable/disable
- Webhook secrets are used for payload signature verification
4. Manage Teams
When to use: User wants to create, view, or manage teams and team event types
Tool sequence:
CAL_GET_TEAMS_LIST - List all teams [Required]
CAL_GET_TEAM_INFORMATION_BY_TEAM_ID - Get specific team details [Optional]
CAL_CREATE_TEAM_IN_ORGANIZATION - Create a new team [Optional]
CAL_RETRIEVE_TEAM_EVENT_TYPES - List event types for a team [Optional]
Key parameters:
teamId: Team identifier
name: Team name (for creation)
slug: URL-friendly team identifier
Pitfalls:
- Team creation may require organization-level permissions
- Team event types are separate from personal event types
- Team slugs must be URL-safe and unique within the organization
5. Organization Management
When to use: User wants to view organization details
Tool sequence:
CAL_GET_ORGANIZATION_ID - Get the organization ID [Required]
Key parameters: (none required)
Pitfalls:
- Organization ID is needed for team creation and org-level operations
- Not all Cal.com accounts have organizations; personal plans may return errors
Common Patterns
Booking Creation Flow
1. Call CAL_GET_AVAILABLE_SLOTS_INFO to find open slots
2. Present available times to the user
3. Call CAL_POST_NEW_BOOKING_REQUEST with selected slot
4. Confirm booking creation response
ID Resolution
Team name -> Team ID:
1. Call CAL_GET_TEAMS_LIST
2. Find team by name in response
3. Extract id field
Webhook Setup
1. Call CAL_RETRIEVE_WEBHOOKS_LIST to check existing hooks
2. Create or update webhook with desired triggers
3. Verify webhook fires on test booking
Known Pitfalls
Date/Time Formats:
- Booking times: ISO 8601 with timezone (e.g., '2024-01-15T09:00:00Z')
- Availability dates: YYYY-MM-DD format
- Always specify timezone explicitly to avoid confusion
Event Types:
- Event type IDs are numeric integers
- Event types define duration, location, and booking rules
- Disabled event types cannot accept new bookings
Permissions:
- Team operations require team membership or admin access
- Organization operations require org-level permissions
- Webhook management requires appropriate access level
Rate Limits:
- Cal.com API has rate limits per API key
- Implement backoff on 429 responses
Quick Reference
| Task |
Tool Slug |
Key Params |
| List bookings |
CAL_FETCH_ALL_BOOKINGS |
status, afterStart, beforeEnd |
| Create booking |
CAL_POST_NEW_BOOKING_REQUEST |
eventTypeId, start, end, name, email |
| Get busy times |
CAL_RETRIEVE_CALENDAR_BUSY_TIMES |
dateFrom, dateTo |
| Get available slots |
CAL_GET_AVAILABLE_SLOTS_INFO |
eventTypeId, dateFrom, dateTo |
| List webhooks |
CAL_RETRIEVE_WEBHOOKS_LIST |
(none) |
| Get webhook |
CAL_GET_WEBHOOK_BY_ID |
id |
| Update webhook |
CAL_UPDATE_WEBHOOK_BY_ID |
id, subscriberUrl, eventTriggers |
| Delete webhook |
CAL_DELETE_WEBHOOK_BY_ID |
id |
| List teams |
CAL_GET_TEAMS_LIST |
(none) |
| Get team |
CAL_GET_TEAM_INFORMATION_BY_TEAM_ID |
teamId |
| Create team |
CAL_CREATE_TEAM_IN_ORGANIZATION |
name, slug |
| Team event types |
CAL_RETRIEVE_TEAM_EVENT_TYPES |
teamId |
| Get org ID |
CAL_GET_ORGANIZATION_ID |
(none) |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: cal-com-automation3description: "Automate Cal.com tasks via Rube MCP (Composio): manage bookings, check availability, configure webhooks, and handle teams. Always search tools first for current schemas."4version: 1.0.05author:6 name: "sickn33 / Antigravity Community"7 github: sickn338tags: [cal, com, automation, productivity]9category: productivity10platforms: [macos, linux, windows]11license: MIT12metadata:13 hermes:14 source: https://skillmd.com/skills/nous-hermeshub/cal-com-automation15 upstream: "antigravity-awesome-skills"16 risk: "critical"17 date_added: "2026-02-27"18 original_author: "Antigravity Community"19---2021# Cal.com Automation via Rube MCP2223Automate Cal.com scheduling operations through Composio's Cal toolkit via Rube MCP.2425## Prerequisites2627- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)28- Active Cal.com connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `cal`29- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas3031## Setup3233**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.3435361. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds372. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `cal`383. If connection is not ACTIVE, follow the returned auth link to complete Cal.com authentication394. Confirm connection status shows ACTIVE before running any workflows4041## Core Workflows4243### 1. Manage Bookings4445**When to use**: User wants to list, create, or review bookings4647**Tool sequence**:481. `CAL_FETCH_ALL_BOOKINGS` - List all bookings with filters [Required]492. `CAL_POST_NEW_BOOKING_REQUEST` - Create a new booking [Optional]5051**Key parameters for listing**:52- `status`: Filter by booking status ('upcoming', 'recurring', 'past', 'cancelled', 'unconfirmed')53- `afterStart`: Filter bookings after this date (ISO 8601)54- `beforeEnd`: Filter bookings before this date (ISO 8601)5556**Key parameters for creation**:57- `eventTypeId`: Event type ID for the booking58- `start`: Booking start time (ISO 8601)59- `end`: Booking end time (ISO 8601)60- `name`: Attendee name61- `email`: Attendee email62- `timeZone`: Attendee timezone (IANA format)63- `language`: Attendee language code64- `metadata`: Additional metadata object6566**Pitfalls**:67- Date filters use ISO 8601 format with timezone (e.g., '2024-01-15T09:00:00Z')68- `eventTypeId` must reference a valid, active event type69- Booking creation requires matching an available slot; check availability first70- Time zone must be a valid IANA timezone string (e.g., 'America/New_York')71- Status filter values are specific strings; invalid values return empty results7273### 2. Check Availability7475**When to use**: User wants to find free/busy times or available booking slots7677**Tool sequence**:781. `CAL_RETRIEVE_CALENDAR_BUSY_TIMES` - Get busy time blocks [Required]792. `CAL_GET_AVAILABLE_SLOTS_INFO` - Get specific available slots [Required]8081**Key parameters**:82- `dateFrom`: Start date for availability check (YYYY-MM-DD)83- `dateTo`: End date for availability check (YYYY-MM-DD)84- `eventTypeId`: Event type to check slots for85- `timeZone`: Timezone for the availability response86- `loggedInUsersTz`: Timezone of the requesting user8788**Pitfalls**:89- Busy times show when the user is NOT available90- Available slots are specific to an event type's duration and configuration91- Date range should be reasonable (not months in advance) to get accurate results92- Timezone affects how slots are displayed; always specify explicitly93- Availability reflects calendar integrations (Google Calendar, Outlook, etc.)9495### 3. Configure Webhooks9697**When to use**: User wants to set up or manage webhook notifications for booking events9899**Tool sequence**:1001. `CAL_RETRIEVE_WEBHOOKS_LIST` - List existing webhooks [Required]1012. `CAL_GET_WEBHOOK_BY_ID` - Get specific webhook details [Optional]1023. `CAL_UPDATE_WEBHOOK_BY_ID` - Update webhook configuration [Optional]1034. `CAL_DELETE_WEBHOOK_BY_ID` - Remove a webhook [Optional]104105**Key parameters**:106- `id`: Webhook ID for GET/UPDATE/DELETE operations107- `subscriberUrl`: Webhook endpoint URL108- `eventTriggers`: Array of event types to trigger on109- `active`: Whether the webhook is active110- `secret`: Webhook signing secret111112**Pitfalls**:113- Webhook URLs must be publicly accessible HTTPS endpoints114- Event triggers include: 'BOOKING_CREATED', 'BOOKING_RESCHEDULED', 'BOOKING_CANCELLED', etc.115- Inactive webhooks do not fire; toggle `active` to enable/disable116- Webhook secrets are used for payload signature verification117118### 4. Manage Teams119120**When to use**: User wants to create, view, or manage teams and team event types121122**Tool sequence**:1231. `CAL_GET_TEAMS_LIST` - List all teams [Required]1242. `CAL_GET_TEAM_INFORMATION_BY_TEAM_ID` - Get specific team details [Optional]1253. `CAL_CREATE_TEAM_IN_ORGANIZATION` - Create a new team [Optional]1264. `CAL_RETRIEVE_TEAM_EVENT_TYPES` - List event types for a team [Optional]127128**Key parameters**:129- `teamId`: Team identifier130- `name`: Team name (for creation)131- `slug`: URL-friendly team identifier132133**Pitfalls**:134- Team creation may require organization-level permissions135- Team event types are separate from personal event types136- Team slugs must be URL-safe and unique within the organization137138### 5. Organization Management139140**When to use**: User wants to view organization details141142**Tool sequence**:1431. `CAL_GET_ORGANIZATION_ID` - Get the organization ID [Required]144145**Key parameters**: (none required)146147**Pitfalls**:148- Organization ID is needed for team creation and org-level operations149- Not all Cal.com accounts have organizations; personal plans may return errors150151## Common Patterns152153### Booking Creation Flow154155```1561. Call CAL_GET_AVAILABLE_SLOTS_INFO to find open slots1572. Present available times to the user1583. Call CAL_POST_NEW_BOOKING_REQUEST with selected slot1594. Confirm booking creation response160```161162### ID Resolution163164**Team name -> Team ID**:165```1661. Call CAL_GET_TEAMS_LIST1672. Find team by name in response1683. Extract id field169```170171### Webhook Setup172173```1741. Call CAL_RETRIEVE_WEBHOOKS_LIST to check existing hooks1752. Create or update webhook with desired triggers1763. Verify webhook fires on test booking177```178179## Known Pitfalls180181**Date/Time Formats**:182- Booking times: ISO 8601 with timezone (e.g., '2024-01-15T09:00:00Z')183- Availability dates: YYYY-MM-DD format184- Always specify timezone explicitly to avoid confusion185186**Event Types**:187- Event type IDs are numeric integers188- Event types define duration, location, and booking rules189- Disabled event types cannot accept new bookings190191**Permissions**:192- Team operations require team membership or admin access193- Organization operations require org-level permissions194- Webhook management requires appropriate access level195196**Rate Limits**:197- Cal.com API has rate limits per API key198- Implement backoff on 429 responses199200## Quick Reference201202| Task | Tool Slug | Key Params |203|------|-----------|------------|204| List bookings | CAL_FETCH_ALL_BOOKINGS | status, afterStart, beforeEnd |205| Create booking | CAL_POST_NEW_BOOKING_REQUEST | eventTypeId, start, end, name, email |206| Get busy times | CAL_RETRIEVE_CALENDAR_BUSY_TIMES | dateFrom, dateTo |207| Get available slots | CAL_GET_AVAILABLE_SLOTS_INFO | eventTypeId, dateFrom, dateTo |208| List webhooks | CAL_RETRIEVE_WEBHOOKS_LIST | (none) |209| Get webhook | CAL_GET_WEBHOOK_BY_ID | id |210| Update webhook | CAL_UPDATE_WEBHOOK_BY_ID | id, subscriberUrl, eventTriggers |211| Delete webhook | CAL_DELETE_WEBHOOK_BY_ID | id |212| List teams | CAL_GET_TEAMS_LIST | (none) |213| Get team | CAL_GET_TEAM_INFORMATION_BY_TEAM_ID | teamId |214| Create team | CAL_CREATE_TEAM_IN_ORGANIZATION | name, slug |215| Team event types | CAL_RETRIEVE_TEAM_EVENT_TYPES | teamId |216| Get org ID | CAL_GET_ORGANIZATION_ID | (none) |217218## When to Use219This skill is applicable to execute the workflow or actions described in the overview.220221## Limitations222- Use this skill only when the task clearly matches the scope described above.223- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.224- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.