cal-mcp

calcom/cal-mcp

3.3

If you are the rightful owner of cal-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Cal.com's MCP Server is a tool for integrating large language models with Cal.com using the Model Context Protocol.

Tools

  1. getBooking

    Retrieve a specific booking.

  2. getBookings

    Retrieve a list of bookings.

  3. createBooking

    Create a new booking.

  4. rescheduleBooking

    Reschedule an existing booking.

  5. cancelBooking

    Cancel a booking.

  6. getEventTypes

    Retrieve a list of event types.

  7. getEventTypeById

    Retrieve details of a specific event type by ID.

  8. updateEventType

    Update an existing event type.

  9. deleteEventType

    Delete an event type.

Cal.com MCP Server

⚠️ Warning: This project is in active development and subject to rapid changes. Features and APIs may be modified frequently. If you have feedback or workflows you'd like to see supported, please get in touch.

Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems or services like Cal.com.

Cal.com's MCP server allows you to use any MCP Client (Claude Desktop, Cursor, Windsurf and many others) to use natural language and your LLM to accomplish things with Cal.com.

Setup

Requirements

  • Node.js >= v18.0.0
  • MCP Client
  • Cal.com API Key - get this from your Cal.com account settings

⚠️ Security Warning: Never share or commit your Cal.com API Key. If exposed, immediately rotate it in your Cal.com account.

Installation

Installation will vary depending on your client, but in most cases you'll need to add the JSON below to your MCP config file. Be sure to insert your Cal.com API token.

{
  "mcpServers": {
    "cal": {
      "command": "npx",
      "args": [
        "@calcom/cal-mcp@latest"
      ],
      "env": {
        "CAL_API_KEY": "YOUR CAL API KEY"
      }
    }
  }
}

Features

This project supports tools for all Cal.com API endpoints by setting the --all-tools flags`. It also supports some prompt workflows tested in Cursor which allow you to quickstart Cal.com applications.

Supported Tools

By default, the following core Cal.com API tools are enabled:

  • getBooking
  • getBookings
  • createBooking
  • rescheduleBooking
  • cancelBooking
  • getEventTypes
  • getEventTypeById
  • updateEventType
  • deleteEventType

To access additional tools:

  1. Add the --all-tools or -a to args in your MCP configuration
  2. Run the MCP server
  3. Use your MCP client's tool discovery feature