outlook-classic-windows-mcp

로컬에 구성된 클래식 Outlook for Windows 데스크톱 프로필과 함께 작동하는 MVP MCP 서버입니다.

이 도구는 Microsoft Graph, Outlook on the web, 새 Outlook for Windows 또는 관리자 권한이 필요한 클라우드 API를 사용하지 않습니다. MCP 서버가 실행 중인 머신에서 사용 가능한 클래식 Outlook 데스크톱 앱/프로필에 대해 Windows COM 자동화를 사용합니다. IT 지원팀에 문의하거나 관리자의 승인을 받고 싶지 않을 때 유용합니다.

참고: 이 MCP는 제 개인 워크플로와 요구 사항에 특화되어 있습니다. 포크하여 수정하거나 코딩 에이전트에게 요청하여 자신의 Outlook 설정과 사용 사례에 맞게 MCP를 조정하는 것이 좋습니다.

경고: Microsoft 365 사용자를 위한 클래식 Outlook for Windows는 최소 2029년까지 지원됩니다. 새 Outlook이 점차 기본값 또는 대체 앱이 됩니다. 이 MCP는 단기/중기적으로만 사용할 수 있습니다. 장기적으로는 관리자 지원 API를 사용하는 다른 MCP를 사용하세요! https://learn.microsoft.com/en-us/answers/questions/5554339/when-will-classic-outlook-end 참조

요구 사항

• Windows

• 클래식 Microsoft Outlook 데스크톱이 설치 및 구성되어 있어야 함

• uv

설치 / 실행

cd C:\Users\muhammad.menjeni\git\outlook-classic-windows-mcp
uv sync
uv run outlook-local-mcp

MCP 서버는 stdio를 사용하므로 MCP 클라이언트에 의해 실행되도록 설계되었습니다.

Pi MCP 구성 예시

Pi MCP 구성에 다음과 유사한 로컬 서버 항목을 추가하고, 필요에 따라 경로를 조정하세요:

{
  "mcpServers": {
    "outlook-local": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\muhammad.menjeni\\git\\outlook-classic-windows-mcp",
        "run",
        "outlook-local-mcp"
      ]
    }
  }
}

도구

search_email

제목 및/또는 본문으로 Outlook 메일을 검색합니다.

인자:

• query 문자열: 대소문자를 구분하지 않는 부분 문자열 검색어.

• folder 문자열: 검색할 폴더. 기본값: Inbox. Inbox/Archive 또는 Mailbox Name/Inbox와 같은 경로를 사용할 수 있습니다.

• search_scope: all, subject 또는 body. 기본값: all.

• max_results: 반환할 일치 항목 수. 기본값: 10.

• max_items: 폴더에서 검사할 최신 항목 수. 기본값: 500.

• include_body_preview: 짧은 본문 미리보기 포함 여부. 기본값: true.

list_mail_folders

폴더 경로 선택에 도움이 되도록 사용 가능한 Outlook 폴더를 나열합니다.

create_leave_calendar_blocks

휴가 검토를 위해 전송되지 않은 두 개의 Outlook 일정 항목을 생성합니다:

1. 참석자가 없는 Out of Office로 표시된 개인 차단 항목.

2. 제공된 참석자가 포함된 Free로 표시된 알림 회의.

아무것도 전송되지 않습니다. 기본적으로 두 항목 모두 저장되고 수동 검토/전송을 위해 Outlook에서 열립니다.

인자:

• start_time 문자열: 시작 날짜/시간, 예: 2026-09-01 08:00.

• end_time 문자열: 종료 날짜/시간. 종일 이벤트의 경우 종료일을 포함하지 않는 날짜로 해석됩니다. 예: 2026-09-04 00:00부터 2026-09-05 00:00까지 하루.

• required_attendees 목록/문자열: 추가 알림 수신자. 구성 가능한 기본값도 사용할 수 있습니다.

• subject 문자열: 기본값은 구성에서 가져오며, 초기값은 Amirul: On-Leave입니다.

• body 문자열: 메시지 본문.

• optional_attendees 목록/문자열: 선택적 알림 수신자.

• location 문자열.

• display 부울: 저장된 항목을 Outlook에서 열지 여부. 기본값: true.

• confirmed 부울: 실제로 Outlook 일정 항목을 생성하려면 true여야 합니다. 확인이 없으면 도구는 제안만 반환합니다.

get_leave_defaults

현재 휴가 기본값과 구성 경로를 표시합니다.

set_leave_defaults

제목 및 알림 수신자와 같은 휴가 기본값을 영구 저장합니다. 구성을 작성하려면 confirmed=true가 필요합니다.

infer_leave_recipients

휴가 알림을 위한 후보 메일 그룹을 추론하기 위해 최근 로컬 Outlook 이메일을 읽기 전용으로 스캔합니다. 후보와 증거를 반환하며, 구성을 작성하거나 초안을 만들지 않습니다.

resolve_recipients

Outlook 받는 사람 확인/주소록을 사용하여 이름, 이메일 또는 메일 그룹을 확인합니다.

search_contacts

이름, 이메일, 회사, 부서 또는 직함으로 로컬 Outlook 연락처 폴더를 검색합니다.

참고 사항 / 제한 사항

• 처음 접근 시 Outlook이 실행 중이 아니면 시작될 수 있습니다.

• 조직에서 Outlook 개체 모델 가드 프롬프트를 표시하거나 정책에 따라 자동화를 차단할 수 있습니다.

• 이 MVP는 최근 폴더 항목을 스캔하여 검색하므로 간단하고 안정적이지만 매우 큰 폴더의 경우 인덱싱된 Outlook 검색만큼 빠르지 않습니다.