Cal.com MCP
In one line: Connect Cal.com so your UnleashX agent can check availability, book meetings, reschedule or cancel them, and manage webhooks automatically.
| Category | Productivity |
| Authentication | API Key |
| Setup time | ~5 minutes |
| Difficulty | Easy |
| Best for | Anyone who wants their agent to schedule and manage meetings on their behalf |
1. Overview
Cal.com is an open-source scheduling platform. You publish event types (like “30-minute intro call”), share a booking link, and invitees pick a time that fits your availability — no back-and-forth emails. Once connected, your UnleashX agent can look up your event types, check open slots, create bookings, reschedule or cancel them, and set up webhooks so other systems hear about new bookings. That lets your agent handle scheduling end to end during a call or chat. Connecting Cal.com to UnleashX is useful for sales, support, and customer teams who want to turn “let’s find a time” into a confirmed meeting instantly, without leaving the conversation.2. What you’ll need
- A Cal.com account (cloud at cal.com or your self-hosted instance).
- At least one event type set up so there’s something to book.
- A Cal.com API key.
Any Cal.com user can create an API key for their own account. The key acts as you, so the agent can only manage the bookings and event types your account owns.
3. Get your credentials
Cal.com uses an API Key.Open Cal.com settings
Sign in at https://app.cal.com and open Settings.
Go to Developer → API keys
In the sidebar, choose Developer, then API keys. (Direct link: https://app.cal.com/settings/developer/api-keys)
Create a key
Click Add / Create new API key, name it
UnleashX, optionally set an expiration, and confirm.| Scope / Access | Why UnleashX needs it |
|---|---|
| Read event types | To know what meetings can be booked and their durations |
| Read availability | To find open time slots before booking |
| Create & manage bookings | To book, reschedule, and cancel meetings |
| Manage webhooks | To notify other systems when bookings change |
A Cal.com API key reflects your account’s access. UnleashX only calls the endpoints needed for the tools listed in Section 5.
4. Connect on UnleashX
Open your agent
Go to https://www.tryunleashx.com and open the agent you want to connect.
Paste your API key
Paste your Cal.com API key. UnleashX sends it as a Bearer token (
access-token / token header).
5. Available tools
| Tool | What it does | Changes data? |
|---|---|---|
| Get Booking | Gets details of a single booking | No |
| List Bookings | Lists bookings | No |
| List Bookings with Changes | Lists bookings including recent changes | No |
| Create Booking | Creates a new booking | ✏️ Yes |
| Reschedule Booking | Reschedules an existing booking | ✏️ Yes |
| Delete Booking | Cancels/deletes a booking | ⚠️ Yes |
| List Event Types | Lists your event types | No |
| Get Availability | Checks available time slots | No |
| Create Webhook | Creates a webhook subscription | ✏️ Yes |
| List Webhooks | Lists your webhooks | No |
| Delete Webhook | Deletes a webhook | ⚠️ Yes |
6. Example usage
“Book a 30-minute intro call with this lead tomorrow at 2pm.” Behind the scenes: List Event Types → Get Availability → Create Booking. “Move my 3pm meeting with Sam to Thursday morning.” Behind the scenes: List Bookings → Get Availability → Reschedule Booking.7. Permissions & data access
UnleashX CAN:- Read your event types, availability, and bookings.
- Create, reschedule, and cancel bookings.
- Create, list, and delete webhooks.
- Access another user’s Cal.com account or bookings.
- Change Cal.com account, billing, or team settings.
- Act beyond what your API key’s account can do.
8. Troubleshooting
| Problem | What it means | How to fix it |
|---|---|---|
401 Unauthorized | The API key is wrong, expired, or deleted | Create a new key in Settings → Developer → API keys and reconnect |
403 Forbidden | The key’s account lacks permission for that action | Verify the account owns the event type/booking, then retry |
404 Not Found | The booking or event type ID doesn’t exist | Re-list to get a current ID; it may have been cancelled |
| No slots returned | The event type has no open availability | Check the event type’s availability schedule in Cal.com |
| Booking fails | Required fields (name/email/time) missing or slot taken | Re-check availability and provide all attendee details |
9. Frequently asked questions
Is my data stored by UnleashX? UnleashX calls Cal.com live with your key when a tool runs. It doesn’t keep a separate copy of your calendar. Can multiple team members connect? Yes. Each person creates their own API key and connects it to their agent. How do I rotate my key? Create a new key in Cal.com, update it in UnleashX, then delete the old one. Access switches over immediately. Does this work with self-hosted Cal.com? Yes, as long as your instance exposes the Cal.com API and you provide a valid API key.10. References
- Cal.com API documentation: https://cal.com/docs/api-reference
- API keys page: https://app.cal.com/settings/developer/api-keys
- Cal.com developer docs: https://cal.com/docs