Cal.com MCP

공식

Model Context Protocol을 통해 호스팅 서버(mcp.cal.com) 또는 로컬 인스턴스를 사용하여 AI 클라이언트를 Cal.com 스케줄링에 연결합니다.

cal.com에서 보기

Cal Com MCP(으)로 무엇을 할 수 있나요?

  • Check your upcoming bookings — Ask for a list of your bookings with filters like date range or status using get_bookings.
  • Create and manage event types — Create, update, or delete event types such as a "Quick Chat" via create_event_type and related tools.
  • Reschedule or cancel meetings — Reschedule a booking to a new time with reschedule_booking or cancel it entirely with cancel_booking.
  • Find available time slots — Retrieve open slots for a given date range using get_availability before scheduling.
  • Manage your schedules — View, create, or modify your availability schedules with get_schedules and create_schedule.
  • Handle booking attendees — View all attendees for a booking with get_booking_attendees or add new ones with add_booking_attendee.

문서

MCP 서버

mcp.cal.com의 호스팅 서버 또는 로컬 인스턴스를 사용하여 모델 컨텍스트 프로토콜을 통해 AI 클라이언트를 Cal.com 일정 관리에 연결하세요.

Cal.com MCP 서버는 Cal.com API v2를 모델 컨텍스트 프로토콜로 감싸서, MCP 호환 클라이언트에서 자연어를 통해 예약, 이벤트 유형, 일정 등을 관리할 수 있게 해줍니다.

호스팅 서버 (mcp.cal.com)

가장 빠르게 시작하는 방법은 MCP 클라이언트를 mcp.cal.com에 직접 연결하는 것입니다. 호스팅 서버는 OAuth 2.1 인증과 함께 Streamable HTTP 전송을 사용하므로, 클라이언트가 인증 흐름을 자동으로 처리합니다.

클라이언트 연결하기

MCP 클라이언트를 호스팅 서버 URL로 지정하세요:

https://mcp.cal.com/mcp

처음 연결하면 클라이언트가 OAuth 인증 흐름을 안내하며, 여기서 Cal.com 계정에 대한 서버 접근 권한을 부여합니다. API 키는 필요하지 않습니다.

`claude_desktop_config.json`에 다음을 추가하세요: 
* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
**설정 → MCP**를 열고 URL `https://mcp.cal.com/mcp`으로 새 서버를 추가하거나, `.cursor/mcp.json`에 추가하세요: 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
VS Code MCP 설정에 서버를 추가하세요: 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

자체 호스팅 서버 (stdio)

로컬에서 서버를 실행하려면 API 키와 함께 stdio 전송을 사용할 수 있습니다. 이는 개발 중이거나 서버를 완전히 제어하고 싶을 때 유용합니다.

사전 요구 사항

클라이언트 연결하기

MCP 클라이언트 설정에 다음을 추가하세요:

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

cal_live_xxxx을 실제 API 키로 교체하세요.

API 키를 절대 공유하거나 커밋하지 마세요. 노출된 경우 [Cal.com 설정](https://app.cal.com/settings/developer/api-keys)에서 즉시 재발급하세요.

사용 가능한 도구

MCP 서버는 카테고리별로 구성된 34개의 도구를 제공합니다:

사용자 프로필

도구설명
get_me인증된 사용자 프로필 가져오기
update_me사용자 프로필 업데이트

이벤트 유형

도구설명
get_event_types모든 이벤트 유형 나열
get_event_typeID로 특정 이벤트 유형 가져오기
create_event_type새 이벤트 유형 생성
update_event_type이벤트 유형 업데이트
delete_event_type이벤트 유형 삭제

예약

도구설명
get_bookings선택적 필터로 예약 나열
get_bookingUID로 특정 예약 가져오기
create_booking새 예약 생성
reschedule_booking예약 일정 변경
cancel_booking예약 취소
confirm_booking보류 중인 예약 확정
mark_booking_absent예약 부재 표시
get_booking_attendees예약의 모든 참석자 가져오기
add_booking_attendee예약에 참석자 추가
get_booking_attendee특정 참석자 가져오기

일정

도구설명
get_schedules모든 일정 나열
get_scheduleID로 특정 일정 가져오기
create_schedule새 일정 생성
update_schedule일정 업데이트
delete_schedule일정 삭제
get_default_schedule기본 일정 가져오기

가능 시간

도구설명
get_availability가능한 시간 슬롯 가져오기
get_busy_times캘린더에서 바쁜 시간 가져오기

회의

도구설명
get_conferencing_apps회의 애플리케이션 나열

라우팅 폼

도구설명
calculate_routing_form_slots라우팅 폼 응답에 기반한 슬롯 계산

조직

도구설명
get_org_memberships모든 조직 멤버십 가져오기
create_org_membership조직 멤버십 생성
get_org_membership조직 멤버십 가져오기
delete_org_membership조직 멤버십 삭제
get_org_routing_forms조직 라우팅 폼 가져오기
get_org_routing_form_responses라우팅 폼 응답 가져오기

프롬프트 예시

연결되면 자연어로 Cal.com과 상호 작용할 수 있습니다:

  • "이번 주에 어떤 예약이 있나요?"
  • "'빠른 채팅'이라는 30분짜리 이벤트 유형을 만들어 줘"
  • "내일 John과의 미팅을 취소해 줘"
  • "다음 주 월요일에 가능한 슬롯을 보여줘"
  • "오후 2시 미팅을 목요일 오후 3시로 일정 변경해 줘"
  • "어떤 이벤트 유형이 있나요?"

관련 자료