Cal.com (MCP)
Overview
Cal.com scheduling allows a MagicBlocks AI Agent to book meetings without manual back-and-forth.
The Agent can identify the correct meeting type, check availability, collect the user’s name and email, create the booking in Cal.com, and confirm the booking in chat.
Cal.com sends the calendar invite or confirmation email after the booking is created.
When to Use
Use Cal.com scheduling when your AI Agent should help users book a meeting, demo, consultation, onboarding call, sales call, or support session.
Cal.com scheduling is useful when a user asks to:
- Book a call
- Schedule a demo
- Find an available time
- Speak with sales or support
- Choose from available meeting slots
Set Up Cal.com
Before an Agent can schedule meetings with Cal.com, Cal.com must be connected in MagicBlocks.
- Go to Library in the left sidebar.
- Open Connections.
- Find Cal.com under Calendar & Scheduling.
- Click Connect.
- Sign in to your Cal.com account.
- Complete the authorization flow.
- Return to MagicBlocks and confirm Cal.com is connected.
After Cal.com is connected, enable the Cal.com tools for the Agent.
- Go to Agents.
- Select the Agent you want to configure.
- Open Brain. Click Advanced
- Go to Select MCP Server or AI Tool.
- On the dropdown, select MCP or AI Tool.
- Below the dropdown, select the Cal.com tools the Agent should use.
- Save and publish the Agent.
Recommended Cal.com Tools
For most booking flows, enable these tools:
Tool | Purpose |
|---|---|
Cal.com List Event Types | Finds available meeting types. |
Cal.com Get Availability | Checks open time slots for the selected event type. |
Cal.com Create Booking | Creates the booking in Cal.com. |
Optional tool:
Tool | Purpose |
|---|---|
Cal.com List Bookings | Lists bookings for review, support, or future scheduling flows. |
Booking Flow
A standard Cal.com booking flow works like this:
- The user asks to schedule or book a meeting.
- The Agent identifies the best event type using Cal.com List Event Types.
- If the event type is unclear, the Agent asks the user to choose from a short list.
- The Agent asks for the user’s timezone if it is missing or unclear.
- The Agent checks available slots using Cal.com Get Availability.
- The Agent shows 3–7 available time options with timezone included.
- The Agent collects and confirms the attendee’s name and email.
- The user selects a time slot.
- The Agent repeats the final booking details and asks for confirmation.
- The Agent creates the booking using Cal.com Create Booking.
- The Agent confirms the booking in chat.
- Cal.com sends the calendar invite or confirmation email.
Example Conversation
User: I want to book a meeting
Agent: I can certainly help you with that! To make sure I set up our meeting perfectly, could you please tell me a bit about what you'd like to discuss?
User: home loan consultation
Agent: Excellent! A home loan consultation is a great way to explore your options.
To help me find the best time for you, could you let me know your preferred day and a general time? For example, "tomorrow afternoon" or "Wednesday morning."
User: I'd like it to be on Thursday afternoon, May 14.
Agent: Got it! Thursday, May 14th, for a home loan consultation.
And what time on Thursday afternoon works best for you?
User: 2PM AEST
Agent: Perfect! I've checked, and Thursday, May 14th, at 2:00 PM AEST (Australian Eastern Standard Time) looks to be available for a home loan consultation.
To finalize this, could you please confirm your email address? This is where I'll send the meeting invitation.
User: [email protected]
Agent: Thank you for confirming your email, [email protected]!
Just to be absolutely sure, could you please confirm that you'd like me to send the meeting invitation for a "Home Loan Consultation" on Thursday, May 14th, at 2:00 PM AEST to [email protected]?
User: Yes, please
Agent: Wonderful! Your Home Loan Consultation is all set for Thursday, May 14th, at 2:00 PM AEST.
An invitation has been sent to [email protected].
Find Available Times
When the user asks for available times, the Agent should check availability with Cal.com Get Availability.
The Agent should use:
- The selected event type
- The requested date or time window
- The user’s timezone
If the user does not provide a date range, the Agent can use a default range such as the next 7–14 days.
The Agent should show a short list of available slots and include the timezone in each option.
Example:
Here are a few available times in GMT+7:
1. Thu May 2 — 14:30
2. Fri May 3 — 09:00
3. Mon May 6 — 15:00
Which one works best?
If no times are available, the Agent should ask for another date range and try again.
Complete a Booking
Before creating a Cal.com booking, the Agent should confirm the final details.
The Agent should confirm:
- Event type
- Date and time
- Timezone
- Attendee name
- Attendee email
Example:
Just to confirm, I’ll book a demo for Alex Tan at [email protected] on Thu May 2 at 14:30 GMT+7. Should I book it?
After the user confirms, the Agent creates the booking with Cal.com Create Booking.
After the booking is created, the Agent should confirm the booking in chat and tell the user to check their email for the calendar invite or confirmation.
Watch the full tutorial below 👇
Best Practices
Use a short list of available time slots. Three to seven options are usually enough.
Always include timezone when showing available times or confirming a booking.
Ask for the attendee’s name and email before creating the booking.
Confirm the user’s email spelling when the email is typed manually.
Always ask for confirmation before creating the booking.
Save and publish the Agent after enabling or changing Cal.com tools.
FAQs
Do I need to connect Cal.com before using it in an Agent?
Yes. Connect Cal.com from Library → Connections, then enable the Cal.com tools inside the Agent.
Where do I enable Cal.com tools?
Enable the tools from Agent → Brain → Advanced → MCP or
Agent → Brain → Advanced → AI Tool.
Which Cal.com tools are required for booking?
The recommended tools are Cal.com List Event Types, Cal.com Get Availability, and Cal.com Create Booking.
What details does the Agent need before booking?
The Agent usually needs the event type, date and time, timezone, attendee name, and attendee email.
What happens if the selected time is unavailable?
The Agent should apologize, check availability again, and offer alternative time slots.
Does Cal.com send the invite?
Yes. After the booking is created, Cal.com sends the calendar invite or confirmation email with the event details.