Cal.com MCP. Manage your entire meeting schedule via natural chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Cal.com MCP Server connects your AI agent to your scheduling infrastructure. It lets you manage all meeting logistics—finding open times, booking new slots, or cancelling existing ones—using plain conversation.
No more switching between calendar apps or writing back-and-forth emails just to sync a simple meeting time. It treats your entire booking process like a natural conversation with your dedicated scheduling coordinator.
What your AI agents can do
Cancel booking
Removes a specific meeting booking from your schedule.
Create new booking
Schedules a new meeting on your calendar.
Get available slots
Finds open time slots when you are free.
The agent can schedule new meetings using create_new_booking, get details on existing ones with get_booking_details, and remove them entirely with cancel_booking.
Use get_available_slots to programmatically find open time blocks based on specified event types and date ranges.
The agent coordinates complex scheduling by first checking availability (get_available_slots), then defining the event type (get_event_type_details), and finally executing the booking (create_new_booking).
The agent pulls your working hours and scheduled times by listing availability schedules (list_availability_schedules) or listing current bookings (list_bookings).
The agent validates the connection and retrieves key user metadata using test_cal_auth or get_my_profile.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Cal.com MCP Server: 12 Tools for Scheduling
Use these tools to manage meeting bookings, check availability, and retrieve event metadata via your AI agent.
019dd0c8cancel booking
Removes a specific meeting booking from your schedule.
019dd0c8create new booking
Schedules a new meeting on your calendar.
019dd0c8get available slots
Finds open time slots when you are free.
019dd0c8get booking details
Retrieves all the information about a specific meeting booking.
019dd0c8get event type details
Gets the template details for a specific type of meeting.
019dd0c8get my profile
Retrieves your user-specific settings and profile data.
019dd0c8list active webhooks
Lists all the event configuration hooks tied to your account.
019dd0c8list availability schedules
Shows your configured working hours and availability rules.
019dd0c8list bookings
Lists all the meetings currently scheduled on your calendar.
019dd0c8list event types
Retrieves the directory of all available meeting templates.
019dd0c8reschedule meeting
Changes the time or date of an existing booking.
019dd0c8test cal auth
Checks the connection between your AI agent and Cal.com.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Cal.com, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Connect your AI client to Cal.com, and you'll manage your entire meeting schedule without lifting a finger. It lets your agent handle the whole process—finding time, booking it, or canceling it—just through plain conversation. You never have to switch between apps or write those annoying back-and-forth emails just to sync a time.
The whole booking process feels like talking to your own dedicated scheduling coordinator.
Managing the Booking Life Cycle: You can schedule new meetings using create_new_booking, check the full details of an existing appointment with get_booking_details, and wipe out old meetings entirely with cancel_booking. Finding Time Slots: Use get_available_slots to programmatically find open time blocks based on what kind of meeting you need and what dates you're looking at. Orchestrating Meetings: The agent coordinates complex scheduling by first checking availability using get_available_slots, defining the event type with get_event_type_details, and then running the booking with create_new_booking. Reviewing Your Calendar: You pull your working hours and scheduled times by listing your availability schedules using list_availability_schedules or listing every meeting currently on your calendar with list_bookings. Checking Account Status: You validate the connection and pull your user data using test_cal_auth or retrieve your user-specific settings and profile data with get_my_profile. Getting Setup: You can pull the directory of all available meeting templates using list_event_types and view all the event configuration hooks tied to your account with list_active_webhooks. Other Tools: You can see what tools are available by running get_my_profile, and you can even change or move an existing appointment using reschedule_meeting.
How Cal.com MCP Works
- 1 Get your API Key from the Cal.com dashboard (Settings > Developer > API Keys).
- 2 Provide your AI agent (Claude, Cursor, etc.) with the API Key and the intent (e.g., 'Book a call').
- 3 Your agent runs the necessary tools (e.g.,
get_available_slots, thencreate_new_booking) and reports the outcome directly to you.
The bottom line is that your AI agent becomes a direct conduit to your calendar, handling the entire process without you ever leaving your current chat window.
Who Is Cal.com MCP For?
This is for professionals whose time is spent coordinating schedules. It helps the Executive Assistant who's tired of managing dozens of booking links. It helps the Sales Director who needs to automate follow-up calls. And it helps the Support Team Lead who has to monitor event performance across multiple teams.
Orchestrates complex, multi-step scheduling flows (e.g., 'Find a slot that works for John, but only if it's a Discovery Call, and then book it').
Automates the scheduling of discovery calls and tracks the performance of different call templates without leaving their CRM or chat window.
Checks who is booked and when, and manages user availability to coordinate follow-up meetings across multiple team members.
What Changes When You Connect
- Stop guessing when to meet. Use
get_available_slotsto find multiple open times in a single prompt, instead of manually checking multiple calendars. - Never send a 'Can you meet next week?' email again. The agent handles the back-and-forth, finding a slot and using
create_new_bookingimmediately. - Need to change a meeting time? Use
reschedule_meetingto update the booking directly. It’s faster than logging into Cal.com and clicking through settings. - See your entire schedule at a glance.
list_bookingspulls all upcoming meetings into the chat, giving you a clear view of your commitments. - Understand your rules. Use
list_availability_schedulesto see what your working hours are, orlist_event_typesto review all available meeting templates. - Get instant status checks. Run
test_cal_authto confirm the connection is active before trying to schedule anything, preventing API errors.
Real-World Use Cases
The Overbooked Executive
The executive needs to clear their schedule for a major project launch. They prompt their agent: 'I need to find three open slots next month for a 'Strategy Session'. Run get_available_slots.' The agent returns three options, and the executive says, 'Book the first one.' The agent then uses create_new_booking and confirms the slot, solving the problem in two prompts.
The Remote Sales Team
A sales rep needs to book a follow-up call with a prospect. They tell their agent, 'Book a 30-minute Discovery Call for Friday morning.' The agent first uses get_event_type_details to confirm the template and then runs get_available_slots to find times, finally calling create_new_booking to lock it down.
The Project Coordinator
The coordinator needs to move a meeting because of a conflict. They tell the agent, 'Move the Q3 Review meeting (ID 987) to Tuesday.' The agent uses get_booking_details to verify the existing meeting and then executes reschedule_meeting, updating the calendar instantly.
The Clean-Up Crew
A team member notices a meeting was scheduled incorrectly. They ask the agent, 'Cancel the meeting with ID 456.' The agent uses cancel_booking, sends the cancellation notice, and updates the calendar immediately. Done.
The Tradeoffs
Sequential manual steps
Checking availability requires opening Cal.com, finding the date picker, selecting the event type, and clicking 'Check.' This takes 5-10 clicks and requires context switching.
→
Just ask your agent: 'Find me three open slots for a Discovery Call next week.' The agent handles the sequence, running get_event_type_details and get_available_slots in the background, and gives you the answer in plain text.
Forgetting booking IDs
Trying to cancel a meeting by just describing it ('the one about Q3'). The system won't know which booking you mean, and you'll have to find the ID manually first.
→
First, use list_bookings to get a list of recent meetings, find the correct ID, and then pass that ID to cancel_booking. It keeps the process structured.
Confusing templates and bookings
Thinking you need to list all event types every time you book, even if you just want to confirm a standard 'Check-in Call.'
→ The agent remembers the templates. You just need to tell it the goal, like 'Schedule a Check-in Call for Tuesday.' The agent handles the template lookup automatically.
When It Fits, When It Doesn't
Use this if your workflow involves any sequence of scheduling actions: finding times, checking templates, or modifying booked slots. You need the AI to act as a single, intelligent layer over your calendar. Don't use it if you just need to view static data, like checking a user's profile details; those are better handled by dedicated user management tools. If your primary goal is to integrate scheduling into a larger process—like triggering a follow-up task when a meeting ends—you need the full suite of tools like list_active_webhooks to manage the lifecycle. Otherwise, stick to dedicated calendar APIs.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Cal.com. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Stop losing time juggling calendar tabs and forms.
Right now, if you need to find a slot for a meeting, you open your calendar. You check your internal availability, then you go to the booking platform. You select the right event type, and if you're lucky, you find a time. If not, you copy a link and send an email asking the other person to suggest times, leading to three rounds of back-and-forth.
With this MCP server, you just tell your agent the goal. It checks your availability, finds the open time, and books it—all in one conversation. You get the confirmation without leaving your chat.
Cal.com MCP Server: Manage meetings & availability
Manual scheduling requires you to switch between the booking platform, your calendar's native UI, and a separate email client just to check if both parties are free. This process is slow, error-prone, and requires constant manual data entry.
The agent runs the tools—like `get_available_slots` and `create_new_booking`—and handles the entire transaction. You just talk to it. It's a single source of truth for your time.
Common Questions About Cal.com MCP
How do I find my free time slots using the `get_available_slots` tool? +
You specify the date range and the event type you need. The agent runs the tool and gives you a list of concrete, available times, saving you from manually checking multiple calendar views.
What is the difference between `list_bookings` and `get_booking_details`? +
list_bookings gives you a list of all your scheduled meetings (the summary). get_booking_details takes a specific booking ID and pulls every single piece of information about that one meeting.
Can I reschedule a meeting using the `reschedule_meeting` tool? +
Yes, you provide the booking ID and the new date/time. The agent updates the booking and sends the necessary notifications, keeping your calendar accurate.
Does `get_event_type_details` tell me what kind of meeting I can book? +
It shows the specific template details, like the default duration and required fields, for a given meeting type. This ensures the agent books the right kind of meeting.
How do I confirm the connection with the `test_cal_auth` tool? +
You ask the agent to run test_cal_auth. This verifies that your API key works and that the agent can communicate with the Cal.com service before you try to book anything.
What information can I retrieve about my user settings using the `get_my_profile` tool? +
The get_my_profile tool provides high-fidelity metadata about your user account. You'll get access to your general profile information, which is useful for reporting and ensuring your agent is acting on the correct identity.
How do I list all the available booking templates with `list_event_types`? +
This tool pulls your entire directory of event types, which are your booking templates. It lists the available meeting formats and their associated details, so your agent knows exactly what types of calls you offer.
What happens if I try to book a meeting with an invalid time or date using `create_new_booking`? +
The system returns a specific error message detailing the invalid input. Your agent can then read this error and prompt you to correct the date or time, preventing failed attempts.
How do I find my Cal.com API Key? +
Log in to your account, navigate to Settings > Developer > API Keys, and create a new key for your integration.
Can I check for available slots via AI? +
Yes! The get_available_slots tool allows your agent to find open times for specific event types and date ranges programmatically.
How do I reschedule a booking? +
Use the reschedule_meeting tool and provide the booking ID along with the new start and end times in JSON format.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Typesense Cloud
Automate search cluster workflows via Typesense Cloud — monitor performance metrics, check cluster health, manage aliases, and execute multi-searches.
Resend Alternative
Send emails and manage domains via Resend — send transactional emails, track deliveries, manage domains and API keys from any AI agent.
Dokku
Manage self-hosted apps via Dokku — monitor containers, scale processes, handle environment variables, and stream logs directly from any AI agent.
You might also like
Helicone (LLM Observability)
Monitor LLM usage via Helicone — track requests, analyze costs, measure latency, and manage prompts.
PagePixels
Capture website screenshots and generate visual previews programmatically with an API that handles rendering at any resolution.
Taranis
Access AI-powered crop scouting via Taranis — detect weeds, diseases, pests, nutrient deficiencies, and get scouting recommendations from ultra-high-resolution imagery.