Skip to main content
Connect your scheduling to Cal.com so you can quickly check availability, create or update bookings, and keep meetings on track without switching tabs. Ask for open slots, manage confirmations, and fetch attendee details using natural language, then plug the structured data directly into your automated workflows.
Work with event types, schedules, availability, and bookings from your Cal.com account in real time using AI-guided prompts.

​
How to Use MCP Nodes

​
What is Cal MCP?

The Cal MCP creates a customized node that understands your Cal.com account and endpoints. You can ask for actions in plain language, and it will return structured data like event types, time slots, and booking details. Create once with a clear prompt, then reuse it across workflows for consistent scheduling operations.

​
What Can It Do for You?

  • List event types and schedules to anchor your automation with reliable identifiers
  • Check availability for an event type over a date range and return bookable time slots
  • Create, confirm, reschedule, decline, or cancel bookings using simple prompts with variables
  • Retrieve your profile or fetch bookings to drive reminders, reporting, and downstream updates

​
Available Tools

ToolWhat It DoesExample Use
Get MeGet your Cal.com user profile information”Return my profile as structured data including user id, username, name, and email”
Get Event TypesGet all event types from Cal.com”List event types and return structured data with id, name, slug, and duration”
Get BookingGet a booking from Cal.com by its unique ID”Using booking id booking id, get the booking and return structured data with id, status, start time, end time, event type, invitee name, and invitee email”
Reschedule BookingReschedule an existing booking to a new time”Using booking id booking id, reschedule to new start time and return structured data with id, new start time, new end time, and status”
Cancel BookingCancel an existing booking”Using booking id booking id, cancel the booking with reason cancellation reason and return structured data with id, status, and cancellation reason”
Confirm BookingConfirm a pending booking”Using booking id booking id, confirm the booking and return structured data with id, status, start time, and end time”
Decline BookingDecline a pending booking”Using booking id booking id, decline the booking with reason decline reason and return structured data with id, status, and decline reason”
Create BookingCreate a booking in Cal.com”Using event type id event type id, create a booking on start time for invitee invitee name with email invitee email and return structured data with booking id, status, start time, end time, and join link”
Get BookingsGet all bookings from Cal.com”List bookings within start date to end date and return structured data with booking id, status, start time, end time, and invitee email”
Get SchedulesGet all schedules from the authenticated user in Cal.com”Return structured data with schedule id, name, timezone, and working hours”
Get AvailabilityGet available time slots for scheduling”Using event type id event type id and date range start date to end date, return structured data with available start times, duration, and timezone”

​
How to Use

1

Create Your Cal MCP Node

Go to your node library, search for Cal, and click “Create a node with AI”
2

Add Your Prompt

Drag the Cal MCP node to your canvas and add your prompt in the text box.
3

Test Your Node

Run the node to see the results. If it works as expected, you’re all set. If you run into issues, check the troubleshooting tips below.
4

Save and Reuse

Once your Cal MCP node is working, save it to your library. You can now use this customized node in any workflow.

​
Example Prompts

Here are some prompts that work well with Cal MCP:
  • Event Types Discovery:
List event types and return structured data with id, name, slug, and duration
  • Check Availability:
Using event type id `event type id` and date range `start date` to `end date`, return structured data with available start times and timezone
  • Create a Booking:
Using event type id `event type id`, create a booking on `start time` for invitee `invitee name` with email `invitee email` and return booking id, status, start time, end time, and join link as structured data
  • Manage an Existing Booking:
Using booking id `booking id`, reschedule to `new start time` and return id, new start time, new end time, and status as structured data
  • Pull Bookings for Reporting:
List bookings within `start date` to `end date` and return booking id, status, start time, end time, and invitee email as structured data
Start with a discovery node like “List event types” or “Get schedules” so you can reference stable ids in later steps. Cal MCP works best with focused, single-action prompts for faster runs and easier reuse.

​
Troubleshooting

If your Cal MCP node isn’t working as expected, try these best practices:

​
Keep Prompts Simple and Specific

  • Good: “List event types and return id and slug”
  • Bad: “Find availability for event type name, pick the first open slot, create the booking, and email the invitee”
While this prompt might work, it’s more efficient to break it into separate nodes. Cal MCP works best with focused, single-action prompts.

​
Match What Cal Can Do

  • Good: “Using booking id booking id, confirm the booking and return id and status”
  • Bad: “Send a reminder email to the invitee for booking booking id”
Cal MCP excels at scheduling data and booking management. For sending emails, combine it with Gmail Sender or Gmail Reader in your workflow.

​
Break Complex Tasks Into Steps

Instead of trying to do everything in one prompt, which might cause timeouts or added complexity: 
Find availability for event type `event type id` between `start date` and `end date`, pick the best slot for `invitee email`, create the booking, and post a Slack message to `channel`
Break this into smaller, focused nodes that each handle one task:
1

Step 1: Get Availability

Using event type id event type id and date range start date to end date, return available start times and timezone as structured data
2

Step 2: Create Booking

Using event type id event type id and chosen slot start time, create a booking for invitee invitee name with email invitee email and return booking id, status, and start time as structured data
3

Step 3: Notify in Slack

Use the Slack Message Sender node in your workflow or the Slack MCP tool in an agent to post the booking on Slack
In your workflow, connect these nodes sequentially. The available time selected in Step 1 becomes the input for Step 2, and the booking id from Step 2 feeds into Step 3.

​
Focus on Data Retrieval

Cal MCP is great at getting scheduling information and managing bookings. For analysis or content creation, connect it to other nodes. Example:
  • Good prompt: “Using booking id booking id, return status, start time, end time, invitee name, and invitee email as structured data”
  • Bad prompt: “Get the booking and write a summary email to the invitee about next steps”
Use Ask AI for summaries or content generation, and Gmail Sender to send emails. Keep the Cal node focused on scheduling data and actions for best results.

​
Troubleshooting Node Creation

If you’re seeing empty outputs in the node creation window (or if you’ve already created the node, hover over it and click “Edit”), use the chat interface to prompt the AI to add debug logs and verify the API response.
In the node creation window (or if you’ve already created the node, hover over it and click “Edit”), use the chat interface to describe what you expected versus what you received. You can click “Request changes” to ask the AI to adjust filters, fields, or logic.
First click “Fix with Gummie”. If multiple attempts do not resolve it, simplify your prompt or contact support.
MCP node creation often benefits from a few tweaks. Use the chat interface in the node creation window to refine filters, output fields, or pagination, to guide adjustments. The AI will update the node based on your feedback.

​
Need More Help?