Skip to main content
The Cal.com MCP server lets you connect AI assistants to your Cal.com account through the Model Context Protocol (MCP). Once connected, you can manage bookings, event types, schedules, and more using natural language — directly from your AI tool.

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?”
The server supports actions across bookings, event types, schedules, availability, conferencing, routing forms, and organization management.

Connect using the hosted server

The quickest way to get started is the hosted server at mcp.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.
Add the server as a custom connector. Connectors work in Claude on the web, Claude Desktop and the mobile apps.
  1. Go to Customize → Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter a name, such as Cal.com, and the URL https://mcp.cal.com/mcp, then click Continue.
  4. Keep the authentication settings Claude detects, then click Add.
  5. Click Connect and sign in to Cal.com to grant access.
On Team and Enterprise plans, an Owner first adds the connector in Organization settings → Connectors. Members then find it in Customize → Connectors and click Connect.To use it in a chat, click + in the message box, open Connectors, and turn on Cal.com.

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:
Never share or commit your API key. If it’s been exposed, rotate it immediately in your Cal.com settings.

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
For anything without a dedicated tool, your AI assistant can find and call any Cal.com API v2 operation through the find_api_operation, describe_api_operation, and call_api_operation tools.