MCP Outlook 캘린더 도구

Microsoft 캘린더 프로토콜(MCP)을 사용하여 Outlook 캘린더 이벤트에 접근하고 관리하는 도구입니다.

설치 및 실행

npx mcp-outlook-calendar

사용법

실행 후, MCP 도구는 http://localhost:3000/mcp 에서 사용할 수 있습니다.

MCP 호환 클라이언트를 사용하여 도구와 상호작용할 수 있습니다.

제공 기능

list-events

Microsoft Outlook 캘린더에서 특정 기간 내 일정 목록을 조회합니다.

파라미터:

• token (필수): Microsoft Graph API에 접근하기 위한 OAuth 액세스 토큰. 사용자의 캘린더 조회 권한(Calendars.Read)이 필요합니다.
• startDateTime (선택): 조회 시작일시 (ISO 8601 형식, 예: 2024-03-20T00:00:00Z). 지정하지 않을 경우 현재 날짜가 사용됩니다.
• endDateTime (선택): 조회 종료일시 (ISO 8601 형식, 예: 2024-03-21T23:59:59Z). 지정하지 않을 경우 시작일로부터 7일 후가 사용됩니다.

응답:

• 일정 목록이 JSON 형식으로 반환됩니다.

API 사용 예시

// MCP Outlook 캘린더 도구 사용 예시 코드
const response = await fetch('http://localhost:3000/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'list-events',
    parameters: {
      token: 'MS-Graph-액세스-토큰',
      startDateTime: '2024-06-01T00:00:00Z',
      endDateTime: '2024-06-07T23:59:59Z',
    },
  }),
});

const result = await response.json();
console.log(result);

인증

이 도구를 사용하려면 캘린더 권한이 있는 유효한 Microsoft Graph API 액세스 토큰이 필요합니다.

필요한 권한 범위

• Calendars.Read: 사용자의 캘린더 읽기 권한

오류 처리

도구 사용 중 발생할 수 있는 일반적인 오류:

• 인증 오류: 잘못된 토큰 또는 권한 부족
• 날짜 형식 오류: 잘못된 ISO 8601 형식의 날짜 입력
• Graph API 오류: Microsoft 서비스 관련 오류

각 오류는 적절한 오류 메시지와 함께 반환됩니다.