Cal.com MCP

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 인증과 함께 스트리밍 가능 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 전송을 사용할 수 있습니다. 이는 개발 중이거나 서버를 완전히 제어하고 싶을 때 유용합니다.

사전 요구 사항

• Node.js >= 18
• Cal.com API 키 — 설정 → 개발자 → API 키에서 생성하세요.

클라이언트 연결하기

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_type	ID로 특정 이벤트 유형 가져오기
create_event_type	새 이벤트 유형 생성
update_event_type	이벤트 유형 업데이트
delete_event_type	이벤트 유형 삭제

예약

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

일정

도구	설명
get_schedules	모든 일정 나열
get_schedule	ID로 특정 일정 가져오기
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과 상호 작용할 수 있습니다:

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

관련 리소스

• AI 에이전트 가이드 — Cal.com API를 직접 사용하여 AI 에이전트 구축하기
• API v2 레퍼런스 — 전체 API 엔드포인트 문서
• GitHub 저장소 — 소스 코드