Cal.com Calendar

🚀 Cal.com Calendar MCP Server

An MCP server implementation integrating Cal.com calendar API, providing appointment scheduling functionality.

🚀 Quick Start

The Cal.com Calendar MCP Server integrates with the Cal.com calendar API to offer appointment scheduling capabilities. You can manage appointments, including adding, updating, deleting, and listing them.

✨ Features

• Add Appointment: Schedule a new calendar meeting with detailed attendee information.
• Update Appointment: Modify details of an existing appointment, such as time and notes.
• Delete Appointment: Cancel and remove an existing appointment.
• List Appointments: View scheduled appointments within a specific date range.

📦 Installation

Obtain API Key

1. Register a new account on Cal.com.
2. Navigate to Settings > Developer > API Keys.
3. Generate a new API key and grant appropriate permissions.

Configuration with Claude Desktop

Add the following content to claude_desktop_config.json:

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

Configuration with NPX

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

Build with Docker

docker build -t mcp/calcom-calendar:latest -f Dockerfile .

💻 Usage Examples

Tools and Their Usage

calcom_add_appointment

• Function: Create a new calendar meeting.
• Input Parameters:
  • eventTypeId (number): Cal.com event type ID.
  • startTime (string): Start time in ISO format (YYYY-MM-DDTHH:mm:ss.sssZ).
  • endTime (string): End time in ISO format (YYYY-MM-DDTHH:mm:ss.sssZ).
  • name (string): Attendee's name.
  • email (string): Attendee's email.
  • notes (string, optional): Meeting notes.

calcom_update_appointment

• Function: Update an existing calendar meeting.
• Input Parameters:
  • bookingId (number): Cal.com booking ID to be updated.
  • startTime (string, optional): New start time in ISO format.
  • endTime (string, optional): New end time in ISO format.
  • notes (string, optional): New notes.

calcom_delete_appointment

• Function: Delete an existing calendar meeting.
• Input Parameters:
  • bookingId (number): Cal.com booking ID to be deleted.
  • reason (string, optional): Reason for deletion.

calcom_list_appointments

• Function: List calendar appointments within a date range.
• Input Parameters:
  • startDate (string): Start date in format YYYY-MM-DD.
  • endDate (string): End date in format YYYY-MM-DD.

📄 License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.