MCP Reference: calendarmcp.googleapis.com

이는 Google Calendar API에서 제공하는 MCP 서버입니다. 서버는 개발자가 Calendar를 기반으로 LLM 애플리케이션을 빌드할 수 있는 도구를 제공합니다.

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 AI 애플리케이션이 이해할 수 있는 형식으로 응답을 변환합니다.

서버 설정

사용하기 전에 Calendar MCP 서버를 구성해야 합니다. Google 및 Google Cloud 원격 MCP 서버 사용에 대한 자세한 내용은 Google Cloud MCP 서버 개요를 참고하세요.

서버 엔드포인트

MCP 서비스 엔드포인트는 AI 애플리케이션 (MCP 클라이언트의 호스트)이 보안 표준 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스 (일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나, 도구를 호출하거나, 리소스에 액세스할 때 사용하는 연락처입니다. Google MCP 엔드포인트는 전역 또는 리전일 수 있습니다.

Calendar API MCP 서버에는 다음과 같은 전역 MCP 엔드포인트가 있습니다.

  • https://calendarmcp.googleapis.com/mcp/v1

MCP 도구

MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 작업을 실행하는 함수 또는 실행 가능한 기능입니다.

도구

calendarmcp.googleapis.com MCP 서버에는 다음과 같은 도구가 있습니다.

MCP 도구
list_events

지정된 조건을 충족하는 지정된 캘린더의 캘린더 일정을 나열합니다.

주요 기능:

  • 모든 캘린더 ID(사용자의 기본 캘린더 또는 기타 캘린더일 수 있음)
  • 키워드 검색 유형
  • 기간 필터링
  • 시간 및 키워드 제약 조건과 일치하는 모든 이벤트를 가져옵니다.

다음과 같은 경우 대신 search_events 도구를 사용하세요.

  • 제약 조건을 충족하는 모든 이벤트가 아닌 가장 관련성이 높은 이벤트 (상위 K개)를 찾아야 합니다.
  • 시맨틱 검색 기능이 필요합니다.
  • 사용자의 기본 캘린더에서만 특정 정보를 검색합니다.

다음과 같은 질문에 이 도구를 사용하세요.

  • 내일 내 일정이 어떻게 돼?
  • 2025년 7월 14일 내 일정이 어떻게 돼?
  • 다음 주에 어떤 회의가 있나요?
  • 오늘 오후에 일정이 겹치는 회의가 있어?

예:

list_events(
    start_time='2024-09-17T06:00:00',
    end_time='2024-09-17T12:00:00',
    page_size=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.
get_event

지정된 캘린더의 단일 이벤트를 반환합니다.

다음과 같은 질문에 이 도구를 사용하세요.

  • 팀 회의의 세부정보를 가져옵니다.
  • 내 캘린더에서 ID가 event123인 일정을 보여 줘.

예:

get_event(
    event_id='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.
list_calendars

사용자의 캘린더 목록에 있는 캘린더를 반환합니다.

다음과 같은 질문에 이 도구를 사용하세요.

  • 내 캘린더는 뭐야?

예:

list_calendars()
# Returns all calendars the authenticated user has access to.
suggest_time

하나 이상의 일정에서 기간을 제안합니다. 기본 캘린더에 액세스하려면 attendee_emails 필드에 'primary'를 추가합니다.

다음과 같은 질문에 이 도구를 사용하세요.

  • 언제 모두가 회의에 참석할 수 있나요?
  • 두 사람이 모두 가능한 30분짜리 시간을 찾아 줘.
  • 월요일 아침에 jane.doe@google.com이 비어 있는지 확인해 줘.

예:

suggest_time(
    attendee_emails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    start_time='2024-09-10T00:00:00',
    end_time='2024-09-17T00:00:00',
    duration_minutes=60,
    preferences={
        'start_hour': '09:00',
        'end_hour': '17:00',
        'exclude_weekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.
create_event

캘린더 일정을 만듭니다.

다음과 같은 질문에 이 도구를 사용하세요.

  • 내일 오후 2시에 '제인과 회의'라는 일정을 내 캘린더에 만들어 줘.
  • 다음 주 월요일 오전 10시부터 11시까지 john.doe@google.com님과의 회의 일정을 예약해 줘.

예:

create_event(
    summary='Meeting with Jane',
    start_time='2024-09-17T14:00:00',
    end_time='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.
update_event

캘린더 일정을 업데이트합니다.

다음과 같은 질문에 이 도구를 사용하세요.

  • '제인과의 회의' 일정을 1시간 후로 변경해 줘.
  • 내일 회의에 john.doe@google.com을 추가해 줘.

예:

update_event(
    event_id='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.
delete_event

캘린더 일정을 삭제합니다.

다음과 같은 질문에 이 도구를 사용하세요.

  • 내 캘린더에서 ID가 event123인 일정을 삭제해 줘.

일정을 취소하거나 거부하려면 대신 respond_to_event 도구를 사용하세요.

예:

delete_event(
    event_id='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.
respond_to_event

이벤트에 응답합니다.

다음과 같은 질문에 이 도구를 사용하세요.

  • 내 캘린더에서 ID가 event123인 일정을 수락해 줘.
  • 제인과의 회의를 거부해 줘.
  • 다음 회의 취소해 줘.
  • 계획 회의를 미정으로 수락합니다.

예:

respond_to_event(
    event_id='event123',
    response_status='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.

MCP 도구 사양 가져오기

MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'