What you can do
With the MCP server connected, you can ask your AI assistant things like:- “What bookings do I have this week?”
- “Create a 30-minute event type called Quick Chat”
- “Cancel my meeting with John tomorrow”
- “Show me my available slots for next Monday”
- “Reschedule my 2pm meeting to Thursday at 3pm”
- “What event types do I have?”
Connect using the hosted server
The quickest way to get started is the hosted server atmcp.cal.com. When you first connect, your AI client walks you through an authorization flow where you grant the server access to your Cal.com account. No API key is needed.
- Claude
- Cursor
- VS Code
Add the server as a custom connector. Connectors work in Claude on the web, Claude Desktop and the mobile apps.
- Go to Customize → Connectors.
- Click + Add, then Add custom connector.
- Enter a name, such as
Cal.com, and the URLhttps://mcp.cal.com/mcp, then click Continue. - Keep the authentication settings Claude detects, then click Add.
- Click Connect and sign in to Cal.com to grant access.
Connect using a self-hosted server
If you prefer to run the server locally, you can use an API key instead of the OAuth flow. This option requires Node.js 18 or later.1
Generate an API key
Go to Settings → Developer → API Keys in your Cal.com dashboard and create a new key.
2
Add the server to your MCP client
Add the following to your MCP client’s configuration, replacing
cal_live_xxxx with your actual API key:Available tools
The MCP server provides tools for:- Profile: view and update your profile
- Event types: list, view, create, update, duplicate, and delete event types, and view their change history
- Bookings: list, create, reschedule, and cancel bookings, and manage attendees
- Availability and calendars: find available slots and check busy times on connected calendars
- Schedules: list, view, create, update, and delete schedules
- Cal Events: list events and invite guests to RSVP
- Teams and organizations: manage team and organization memberships, attributes, and team bookings
- Routing forms: create and edit routing forms, view responses, and calculate slots from a response
- Discover: search Discover listings
- Help: search the Cal.com docs and get links to the right page in the Cal.com app
find_api_operation, describe_api_operation, and call_api_operation tools.