Cal.com MCP
공식Model Context Protocol을 통해 호스팅 서버(mcp.cal.com) 또는 로컬 인스턴스를 사용하여 AI 클라이언트를 Cal.com 스케줄링에 연결합니다.
Cal Com MCP(으)로 무엇을 할 수 있나요?
- 예약 관리 — 어시스턴트에게 예약 목록 조회, 생성, 일정 변경, 취소 또는 확인을 요청하고 참석자를 추가하세요.
- 예약 가능 여부 확인 — 예약 가능한 시간대, 연결된 캘린더의 바쁜 시간, 기본 일정을 확인하세요.
- 이벤트 유형 설정 — 팀 이벤트 유형을 포함해 이벤트 유형을 생성, 업데이트, 복제 또는 삭제하세요.
- 일정 및 연락처 관리 — 일정을 생성하고 수정하며, 개인 연락처를 추가, 업데이트 또는 태그하세요.
- 팀 및 조직 관리 — 팀원을 초대하고 멤버십을 관리하며, 조직의 팀과 속성을 조회하거나 수정하세요.
- 문서 및 API 카탈로그 검색 — Cal.com 문서를 검색하거나 API v2 작업을 찾아 설명을 확인하고 호출하세요.
문서
MCP 서버
mcp.cal.com의 호스팅 서버 또는 로컬 인스턴스를 사용해 Model Context Protocol을 통해 AI 클라이언트를 Cal.com 일정 관리에 연결합니다.
Cal.com MCP 서버는 Cal.com API v2를 Model Context Protocol로 감싸, MCP 호환 클라이언트에서 자연어로 예약, 이벤트 유형, 일정 등을 관리할 수 있게 합니다.
호스팅 서버 (mcp.cal.com)
가장 빠르게 시작하는 방법은 MCP 클라이언트를 mcp.cal.com에 직접 연결하는 것입니다. 호스팅 서버는 OAuth 2.1 인증을 사용하는 Streamable HTTP 전송을 지원하며, 클라이언트가 인증 흐름을 자동으로 처리합니다.
클라이언트 연결
MCP 클라이언트가 호스팅 서버 URL을 가리키도록 설정합니다.
https://mcp.cal.com/mcp
처음 연결하면 클라이언트에서 OAuth 인증 흐름이 시작되어 서버에 Cal.com 계정 접근 권한을 부여하게 됩니다. API 키는 필요하지 않습니다. 모든 MCP 클라이언트가 연결할 수 있습니다. 클라이언트는 POST /oauth/register을 통해 동적으로 등록하거나 Client ID Metadata Document( https client_id URL)로 자신을 식별합니다. Cal.com에 로그인하기 전에 클라이언트 이름과 로그인 후 돌아갈 호스트가 표시된 동의 페이지가 나타납니다.
[!NOTE]
동의 화면에서는 팀 이벤트 유형을 만들고, 수정하고, 삭제하고, 팀 멤버십을 확인하고 관리할 수 있도록 팀 범위도 요청합니다. 이를 통해 AI 클라이언트가 팀 이벤트 유형을 설정하고 팀에 사람을 추가할 수 있습니다. 또한 조직 프로필 범위도 요청하므로 조직 관리자의 AI 클라이언트가 조직의 팀을 나열하고, 만들고, 수정하고, 삭제할 수 있습니다. Cal.com은 모든 호출에서 팀 내 사용자의 역할과 권한을 계속 확인합니다. 개인 연락처를 확인하고, 추가하고, 이름을 바꾸고, 삭제하는 권한도 요청합니다(
CONTACT_READ,CONTACT_WRITE). 이 범위가 추가되기 전에 연결했다면 서버 연결을 해제한 뒤 다시 연결하여 권한을 부여하세요.
[tab] Claude Desktop
다음 내용을
claude_desktop_config.json에 추가합니다.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json- Windows:
%APPDATA%\Claude\claude_desktop_config.json{ "mcpServers": { "calcom": { "url": "https://mcp.cal.com/mcp" } } }
[tab] Cursor
Settings → MCP를 열고 URL이
https://mcp.cal.com/mcp인 새 서버를 추가하거나,.cursor/mcp.json에 추가합니다.{ "mcpServers": { "calcom": { "url": "https://mcp.cal.com/mcp" } } }
[tab] VS Code
VS Code MCP 설정에 서버를 추가합니다.
{ "mcpServers": { "calcom": { "url": "https://mcp.cal.com/mcp" } } }
[tab] fx
다음 내용을
~/.fx/mcp.json에 추가합니다.{ "mcp": { "calcom": { "type": "http", "url": "https://mcp.cal.com/mcp" } } }그런 다음 fx에서
/mcp auth calcom --open을 실행해 인증합니다. 전송 방식, 인증 옵션, 도구 검색에 대한 자세한 내용은 fx MCP 문서를 참조하세요.
[tab] Grok
Grok은 JSON 설정 대신 Cal.com 봇을 통해 연결합니다. Settings → Developer → MCP에서 Client setup 아래의 Grok Bot을 선택한 다음, QR 코드를 스캔하거나 Add Bot을 클릭해 Grok에서 Cal.com 봇을 엽니다.
자체 호스팅 서버 (stdio)
서버를 로컬에서 실행하려면 API 키와 함께 stdio 전송을 사용할 수 있습니다. 개발 중이거나 서버를 완전히 직접 제어하려는 경우에 유용합니다.
사전 요구 사항
- Node.js >= 18
- Cal.com API 키 — Settings → Developer → API Keys에서 생성
클라이언트 연결
MCP 클라이언트의 설정에 다음 내용을 추가합니다.
{
"mcpServers": {
"calcom": {
"command": "npx",
"args": ["@calcom/cal-mcp@latest"],
"env": {
"CAL_API_KEY": "cal_live_xxxx"
}
}
}
}
cal_live_xxxx을 실제 API 키로 바꿉니다.
[!WARNING]
API 키를 공유하거나 커밋하지 마세요. 키가 노출되면 Cal.com 설정에서 즉시 교체하세요.
도구 세트
서버 URL에 toolsets 쿼리 매개변수를 추가하면 세션에 등록할 도구를 제한할 수 있습니다.
https://mcp.cal.com/mcp?toolsets=bookings,availability
사용 가능한 도구 세트: profile, event-types, events, bookings, availability, schedules, calendars, contacts, discover, teams, organizations, routing-forms, catalog (메타 도구 find_api_operation / describe_api_operation / call_api_operation). 알 수 없는 이름을 지정하면 400 invalid_request로 거부됩니다. 매개변수를 생략하면 모든 도구가 등록됩니다. 로컬 도구 get_app_link 및 search_docs은 선택과 관계없이 항상 등록됩니다. 자체 호스팅 stdio 서버에서는 대신 MCP_TOOLSETS를 설정하세요.
대화형 뷰 (MCP Apps)
MCP Apps를 지원하는 클라이언트에서는 get_availability 및 get_bookings가 채팅에 대화형 뷰도 표시합니다. 따라서 입력하는 대신 클릭하여 시간을 선택하고 예약을 관리할 수 있습니다.
- 시간 선택기 (
get_availability): 날짜별로 그룹화된 예약 가능 시간을 표시합니다. 화살표를 사용해 이전 날짜나 이후 날짜로 이동하고, 시간을 클릭한 다음 참석자의 이름과 이메일을 입력하고 Book을 클릭합니다. 기존 예약의 새 시간을 찾는 중이라면 시간을 클릭했을 때 Move booking here가 표시됩니다. - 예약 (
get_bookings): 예약마다 시간과 참석자가 표시된 카드가 하나씩 나타납니다. 예정된 예약에는 Join(예약에 회의 링크가 있는 경우), 다음 주의 예약 가능 시간을 표시해 선택할 수 있는 Reschedule, 카드에서 먼저 확인을 요청하는 Cancel이 표시됩니다.
시간은 클라이언트가 보고하는 시간대로 표시되며, 뷰는 클라이언트의 밝은 테마 또는 어두운 테마를 따릅니다. 작업은 기존 연결에서 동일한 create_booking, reschedule_booking, cancel_booking 도구를 통해 실행되며, 수행한 작업은 어시스턴트에 전달됩니다.
[!NOTE]
뷰를 사용하려면
bookings및availability도구 세트가 모두 활성화되어 있어야 합니다.toolsets를 전달하지 않으면 기본적으로 활성화됩니다. MCP Apps를 지원하지 않는 클라이언트에는 이전과 동일한 텍스트 결과가 표시됩니다.
이벤트 구독 (MCP Events)
호스팅 서버는 MCP Events를 지원하므로, 프로토콜 버전 2026-07-28을 사용하는 클라이언트는 폴링하는 대신 Cal.com 계정에서 발생한 이벤트 알림을 받을 수 있습니다. 서버는 events 기능을 알리고 다음 세 가지 메서드를 처리합니다.
events/list: 구독할 수 있는 이벤트를 반환합니다. 예를 들어booking.created,booking.rescheduled,booking.cancelled,meeting.ended,recording.ready이 있으며, 각 이벤트에는 입력 스키마와 페이로드 스키마가 있습니다.events/subscribe: 이벤트에 콜백 URL을 구독합니다. 콜백은 공개 HTTPS URL이어야 하며,delivery.secret는whsec_비밀 값이어야 합니다. 구독을 저장하기 전에 서버는challenge값이 포함된 서명된 확인 요청을 보냅니다. 엔드포인트는 JSON 응답에 해당 값을 그대로 반환해야 합니다. 같은 URL, 이벤트, 인수로 다시 구독하면 기존 구독이 갱신됩니다.events/unsubscribe: 구독 하나를 삭제합니다. 더 이상 존재하지 않는 구독에 호출해도 성공합니다.
전달되는 이벤트는 사용자의 whsec_ 비밀 값을 사용해 Standard Webhooks 방식으로 서명됩니다. 구독은 기본적으로 7일 후 만료됩니다. ttlMs을 설정하면 1시간에서 30일 사이의 유효 기간을 요청할 수 있습니다.
첫 구독을 만들면 Cal.com 계정에 웹훅이 생성되어 서버의 POST /events/calcom/<ref> 경로로 이벤트를 전송합니다. 마지막 구독을 삭제하면 해당 웹훅도 삭제됩니다. 이 경로를 직접 호출할 필요는 없습니다.
[!NOTE]
MCP Events는 Streamable HTTP 전송에서만 제공되며 자체 호스팅 stdio 서버에서는 제공되지 않습니다. Cal Events RSVP 페이지를 관리하는
events도구 세트와는 관련이 없습니다.
사용 가능한 도구
MCP 서버는 85개의 도구를 범주별로 제공합니다.
앱 링크
| 도구 | 설명 |
|---|---|
get_app_link | Cal.com 웹 앱에서 예약, 이벤트 유형, 일정, 팀, 라우팅 양식 또는 설정 페이지를 여는 URL 생성 |
문서
| 도구 | 설명 |
|---|---|
search_docs | Cal.com 제품 문서 검색. 상위 결과의 발췌문과 함께 관련도 순으로 페이지 반환 |
사용자 프로필
| 도구 | 설명 |
|---|---|
get_me | 인증된 사용자 프로필 가져오기 |
update_me | 사용자 프로필 업데이트 |
이벤트 유형
| 도구 | 설명 |
|---|---|
get_event_types | 모든 이벤트 유형 나열 |
get_event_type | ID로 특정 이벤트 유형 가져오기 |
create_event_type | 새 이벤트 유형 만들기 |
update_event_type | 이벤트 유형 업데이트 |
delete_event_type | 이벤트 유형 삭제 |
duplicate_event_type | 조직 팀 이벤트 유형을 같은 팀 또는 조직 내 다른 팀으로 복제 |
get_event_type_settings | 이벤트 유형 설정 가져오기 |
get_event_type_history | 이벤트 유형 변경 기록 가져오기 |
get_scheduling_config | 이벤트 유형 일정 구성 가져오기 |
get_crm_sync_errors | 이벤트 유형의 CRM 동기화 오류 가져오기 |
이벤트
Cal Events는 cal.com/{slug}에서 제공되는 날짜가 고정된 RSVP 페이지입니다. 이벤트 유형이나 캘린더 이벤트가 아닙니다. get_events 및 get_event에는 EVENT_READ OAuth 범위가 필요하고, invite_cal_event_guests에는 EVENT_WRITE가 필요합니다.
| 도구 | 설명 |
|---|---|
get_events | 소유하거나 공동 주최하는 이벤트를 최신순으로 나열합니다. limit(최대 250) 및 cursor 페이지네이션과 slug 필터를 지원합니다. |
get_event | uuid로 이벤트 하나 가져오기 |
invite_cal_event_guests | 각 이메일 주소, ID로 지정한 연락처(contactIds), 또는 연락처 태그 중 하나가 지정된 모든 연락처(contactTagIds)에 초대 이메일을 보냅니다. 연락처에는 contacts 기능이 필요하며, 각 주소에 대해 처리 결과를 보고합니다. |
예약
| 도구 | 설명 |
|---|---|
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_booking_routing_trace | 예약의 라우팅 추적 정보 가져오기 |
get_org_team_bookings | 조직 팀의 예약 가져오기 |
get_org_user_bookings | 조직 사용자의 예약 가져오기 |
일정
| 도구 | 설명 |
|---|---|
get_schedules | 모든 일정 나열 |
get_schedule | ID로 특정 일정 가져오기 |
create_schedule | 새 일정 만들기 |
update_schedule | 일정 업데이트 |
delete_schedule | 일정 삭제 |
get_default_schedule | 기본 일정 가져오기 |
예약 가능 시간 및 캘린더
| 도구 | 설명 |
|---|---|
get_availability | 예약 가능한 시간대 가져오기 |
get_busy_times | 캘린더의 바쁜 시간 가져오기 |
get_connected_calendars | 연결된 캘린더 나열 |
get_conferencing_apps | 화상 회의 앱 나열 |
연락처
연락처 페이지에 있는 개인 연락처와 해당 태그입니다. 팀 또는 조직 구성원은 포함되지 않습니다. 목록 조회에는 CONTACT_READ OAuth 범위가, 쓰기 작업에는 CONTACT_WRITE이 필요합니다. 태그는 링크와 공유됩니다.
| 도구 | 설명 |
|---|---|
list_contacts | 연락처를 페이지당 50개씩 나열합니다. 특정 태그가 있는 연락처만 선택할 수 있으며, 각 연락처의 Cal 가입 여부와 그룹 회의 참여 가능 여부도 표시합니다. |
add_contact | 이메일로 연락처 추가. 이름은 선택 사항입니다. |
update_contact | 연락처 이름 업데이트. Cal에 가입한 연락처의 이름은 변경할 수 없습니다. |
remove_contact | 연락처와 해당 태그 삭제 |
list_contact_tags | 태그를 페이지당 50개씩 나열하고, 각 태그를 가진 연락처 수 표시 |
create_contact_tag | 연락처에 적용하지 않고 태그 만들기 |
add_contact_tag | 연락처에 태그 하나 적용 |
remove_contact_tag | 연락처에서 태그 하나 제거. 태그 자체는 유지됩니다. |
검색
게시된 Discover 목록은 검색 결과로 반환된 ID를 사용해 검색하거나 읽을 수 있으며, EVENT_TYPE_READ OAuth 범위가 필요합니다. 웹에서 찾은 업체에 전화하거나 온라인으로 예약하고, 제공업체가 가입하면 알림을 요청하려면 PROFILE_WRITE이 필요합니다.
| 도구 | 설명 |
|---|---|
search_listings | 카테고리, 자유 텍스트, 지역, 가격, 소요 시간, 예약 가능한 시간대 범위로 목록을 검색하고 각 목록의 예약 링크를 제공합니다. 해당 지역에 결과가 없으면 그곳에서 웹으로 찾은 업체를 제공합니다 |
get_discover_listings | 공개 카드에 표시되는 방식으로 최대 50개의 목록을 읽고, 선택적으로 각 목록의 향후 7일 중 가장 빠른 예약 가능 시간대를 제공합니다 |
call_business_to_book | 사용자가 승인하면 Cal이 search_listings 웹에서 찾은 업체에 전화해 서비스를 예약하도록 합니다. 통화를 확인할 수 있는 페이지를 반환합니다 |
book_online | 사용자가 승인하면 Cal의 예약 에이전트가 search_listings 웹에서 찾은 업체의 자체 예약 페이지에서 예약하도록 합니다. 작업 페이지를 반환하며, 여기서 사용자가 옵션을 선택하고 가격과 약관을 승인합니다 |
record_service_request | Discover에 목록이 없는 서비스의 제공업체가 가입하면 계정 이메일 주소로 알림을 받도록 요청합니다. 같은 지역에서 같은 필요에 대해 90일 이내에 다시 요청해도 변경 사항은 없습니다 |
팀 및 멤버십
| 도구 | 설명 |
|---|---|
get_my_teams | 소속된 팀 가져오기 |
get_org_teams | 조직 팀 가져오기 |
create_team_invite | 팀에 사용자 초대 |
create_team_membership | 팀 멤버십 생성 |
get_team_memberships | 모든 팀 멤버십 가져오기 |
get_team_membership | 팀 멤버십 가져오기 |
update_team_membership | 팀 멤버십 업데이트 |
delete_team_membership | 팀 멤버십 삭제 |
조직
| 도구 | 설명 |
|---|---|
get_org_memberships | 모든 조직 멤버십 가져오기 |
create_org_membership | 조직 멤버십 생성 |
get_org_membership | 조직 멤버십 가져오기 |
update_org_membership | 조직 멤버십 업데이트 |
delete_org_membership | 조직 멤버십 삭제 |
get_org_attributes | 조직 속성 가져오기 |
get_org_attribute | 조직 속성 가져오기 |
get_attribute_options | 속성 옵션 가져오기 |
get_user_attributes | 사용자에게 할당된 속성 가져오기 |
assign_attribute_to_user | 사용자에게 속성 할당 |
update_user_attribute | 사용자에게 할당된 속성 업데이트 |
unassign_attribute_from_user | 사용자에게 할당된 속성 할당 해제 |
get_user_attribute_history | 사용자의 속성 할당 기록 가져오기 |
라우팅 양식
| 도구 | 설명 |
|---|---|
calculate_routing_form_slots | 라우팅 양식 응답을 바탕으로 시간대 계산 |
get_org_routing_forms | 조직 라우팅 양식 가져오기 |
get_org_routing_form_responses | 라우팅 양식 응답 가져오기 |
get_team_routing_forms | 팀 라우팅 양식 가져오기 |
create_routing_form | 대체 경로로 시작하는 팀 라우팅 양식 생성 |
get_routing_form | 팀 라우팅 양식의 질문과 경로 가져오기 |
get_routing_form_history | 팀 라우팅 양식의 변경 기록을 최신순으로 가져오기: 누가 무엇을 언제 변경했는지 확인합니다. limit (최대 50개) 및 cursor 페이지네이션을 지원합니다 |
edit_routing_form_routes | 팀 라우팅 양식 경로의 수정 사항 미리 보기 및 적용 |
edit_routing_form_fields | 팀 라우팅 양식 질문의 수정 사항 미리 보기 및 적용 |
API 카탈로그
| 도구 | 설명 |
|---|---|
find_api_operation | 전체 API v2 작업 카탈로그 검색 |
describe_api_operation | API 작업의 입력 스키마 가져오기 |
call_api_operation | 카탈로그의 API v2 작업 실행 |
예시 프롬프트
연결한 후에는 자연어를 사용해 Cal.com과 상호작용할 수 있습니다.
- "이번 주에 예약된 일정이 뭐야?"
- "'빠른 채팅'이라는 30분 이벤트 유형을 만들어 줘"
- "내일 John과의 회의를 취소해 줘"
- "다음 주 월요일에 가능한 시간대를 보여 줘"
- "오후 2시 회의를 목요일 오후 3시로 변경해 줘"
- "내 이벤트 유형을 보여 줘"
관련 리소스
- AI 에이전트 가이드 — Cal.com API를 직접 사용해 AI 에이전트 구축
- API v2 참조 — 전체 API 엔드포인트 문서
이 문서는 개발자 문서 플랫폼인 Mintlify에서 빌드 및 호스팅됩니다.
