Cal.com Calendar

Provides appointment scheduling and calendar management via Cal.com API with add, update, delete, and list operations.

javascript

3

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mumunha-cal_dot_com_mcpserver": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CALCOM_API_KEY",
        "mcp/calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

This MCP server integrates Cal.com Calendar API to manage appointments—adding, updating, deleting, and listing bookings. It lets you connect Cal.com calendar data to your platform, enabling streamlined scheduling workflows for your users.

How to use

You interact with this MCP server through supported clients to manage calendar appointments. Use the available tools to create new bookings, modify existing ones, cancel bookings, or retrieve a list of appointments within a date range. Each operation corresponds to a specific tool you can invoke from your MCP client, and you’ll provide the required inputs such as time, attendee details, and notes.

How to install

Prerequisites: you need a runtime environment capable of running the MCP server commands shown below. You will choose among two common installation methods: Docker or NPX.

Get an API key for Cal.comApi access. Sign in to Cal.com, go to Settings > Developer > API Keys, and generate a new API key with the appropriate permissions.
Pick an installation method and run the corresponding commands.

{
  "mcpServers": {
    "calcom_calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CALCOM_API_KEY",
        "mcp/calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

{
  "mcpServers": {
    "calcom_calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Available tools

calcom_add_appointment

Create a new calendar appointment with attendee details including eventTypeId, startTime, endTime, name, email, and optional notes.

calcom_update_appointment

Update an existing calendar appointment identified by bookingId, with optional changes to startTime, endTime, and notes.

calcom_delete_appointment

Delete an existing calendar appointment given a bookingId and optional cancellation reason.

calcom_list_appointments

List calendar appointments within a specified startDate and endDate range.