Cal.com Scheduling Platform Adapter

This implementation serves as a Model Context Protocol (MCP) server interface designed to leverage the Cal.com Application Programming Interface (API) for robust appointment orchestration.

Core Capabilities

• Initiate Engagements: Provisioning of novel calendar reservations, capturing necessary attendee data.
• Modify Reservations: Altering parameters of existing bookings, such as commencement/conclusion times or associated commentary.
• Terminate Bookings: Official cancellation and subsequent erasure of scheduled slots.
• Inventory Retrieval: Fetching records of scheduled engagements within specified temporal boundaries.

Callable Methods

• calcom_add_appointment
• Function: Secure a new calendar reservation.

• Parameters:

  • eventTypeId (integer): Identifier for the specific event template on Cal.com.
  • startTime (text): The precise start instant, formatted as ISO 8601 (e.g., YYYY-MM-DDTHH:mm:ss.sssZ).
  • endTime (text): The precise conclusion instant, formatted as ISO 8601.
  • name (text): Full designation of the participant.
  • email (text): Electronic mail address for the participant.
  • notes (text, optional): Supplementary context or memos for the entry.

• calcom_update_appointment

• Function: Revise the details of an established booking.

• Parameters:

  • bookingId (integer): The unique locator assigned by Cal.com to the reservation.
  • startTime (text, optional): The newly designated commencement instant.
  • endTime (text, optional): The newly designated conclusion instant.
  • notes (text, optional): Updated descriptive content.

• calcom_delete_appointment

• Function: Invalidate an existing scheduled commitment.

• Parameters:

  • bookingId (integer): The Cal.com identifier of the engagement to void.
  • reason (text, optional): Justification for the cancellation event.

• calcom_list_appointments

• Function: Generate a manifest of scheduled commitments spanning a date interval.
• Parameters:
  • startDate (text): The initial calendar day for the inquiry (Format: YYYY-MM-DD).
  • endDate (text): The terminal calendar day for the inquiry (Format: YYYY-MM-DD).

Deployment Schema

Acquiring Credentials

1. Establish an account via the Cal.com portal.
2. Access the configuration section: Settings -> Developer -> API Secrets.
3. Provision a fresh API token with requisite access privileges.

Integration with Claude Environment

Inject the following configuration into your claude_desktop_config.json file:

Containerized Execution (Docker)

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

Node Package Execution (NPX)

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

Construction Process

For Docker image fabrication:

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

Legal Stipulations

This adapter software is distributed under the stipulations of the MIT License. Users retain liberty to deploy, modify, and disseminate this system, subject to adhering to the outlined terms. Refer to the accompanying LICENSE document within the source repository for comprehensive specifics.