Outlook 레거시 MCP

Claude Desktop을 Windows COM 자동화를 통해 레거시 Microsoft Outlook 설치에 연결합니다.

이 프로젝트는 특히 Outlook 2007 및 이와 유사한 레거시 데스크톱 Outlook 환경을 위해 설계되었으며, 최신 Outlook/Microsoft 365 통합을 사용할 수 없거나 실용적이지 않은 경우에 적합합니다.

작동 방식

Claude Desktop
      |
      | MCP
      v
Outlook Legacy MCP Server
      |
      | Windows COM / MAPI
      v
Microsoft Outlook Desktop
      |
      v
Configured Outlook Mail Profile

MCP 서버는 Windows 컴퓨터에서 로컬로 실행됩니다. Exchange, IMAP, SMTP 또는 Microsoft Graph에 직접 연결하지 않습니다.

Related MCP server: Microsoft 365 MCP Server

핵심 기능: MCP에 Outlook 자격 증명 없음

서버는 다음을 요청하거나 저장하지 않습니다:

• Outlook 사용자 이름

• Outlook 비밀번호

• Exchange 서버 정보

• IMAP/SMTP 자격 증명

• Microsoft Graph 자격 증명

• OAuth 토큰

대신 로컬 Windows 컴퓨터에 이미 구성된 Outlook 데스크톱 애플리케이션과 메일 프로필을 사용합니다.

현재 MCP 도구

요구 사항

• Windows

• Microsoft Outlook 2007 또는 COM 호환 데스크톱 Outlook 버전

• Python 3.10+

• Claude Desktop

• 구성된 Outlook 메일 프로필

Outlook은 프로필이 구성되도록 컴퓨터에서 최소 한 번은 실행된 적이 있어야 합니다.

설치

저장소를 클론합니다:

git clone https://github.com/jatinpurba/outlook-legacy-mcp.git
cd outlook-legacy-mcp

의존성을 설치합니다:

pip install -r requirements.txt

직접 설치할 수도 있습니다:

pip install pywin32 mcp

Claude Desktop 구성

Claude Desktop 구성 파일을 엽니다:

%APPDATA%\Claude\claude_desktop_config.json

다음 MCP 서버 항목을 추가합니다. 경로를 컴퓨터에 있는 Python 파일의 실제 위치로 바꾸세요:

{
  "mcpServers": {
    "outlook-legacy": {
      "command": "python",
      "args": [
        "C:\\path\\to\\outlook-legacy-mcp\\outlook_mcp_server.py"
      ]
    }
  }
}

구성을 저장하고 Claude Desktop을 완전히 다시 시작합니다.

그러면 Outlook 도구를 Claude에서 사용할 수 있습니다.

예시 프롬프트

연결이 완료되면 Claude에게 다음과 같은 작업을 요청할 수 있습니다:

Show me my latest 10 emails.

Show me my unread emails.

Read the latest email from John.

Create a draft response to this email.

Create a draft email to customer@example.com with the subject
"Project Update".

send_email은 구성된 Outlook 계정을 통해 메시지를 보내므로 각별히 주의하세요.

보안 및 개인정보 보호

이 MCP 서버는 Windows 컴퓨터에서 로컬로 실행됩니다.

MCP 자체는 Outlook 자격 증명을 수집하거나 저장하지 않습니다. 로컬에 설치된 Outlook 애플리케이션을 통해 Outlook 프로필에 접근합니다.

그러나 MCP 도구는 사서함 콘텐츠에 접근할 수 있고 이메일을 보낼 수 있습니다. 신뢰할 수 있는 컴퓨터에서만 서버를 실행하세요.

자동 전송을 사용하기 전에 AI 시스템이 생성한 메시지의 수신자, 제목, 내용을 검토하세요.

프로그램이 사용자를 대신하여 메일을 보내려고 하면 Outlook에서 보안 프롬프트가 표시될 수 있습니다. 이는 Outlook의 보안 기능입니다.

제한 사항

• Windows 전용

• 데스크톱 Outlook 필요

• 구성된 Outlook 프로필 필요

• Outlook Windows COM 자동화 사용

• 서버 측/헤드리스 배포보다는 로컬 사용을 위한 것

• COM 작업을 위해 Outlook이 실행 중이거나 실행 가능해야 할 수 있음

• 메일 전송 시 Outlook 보안 프롬프트가 나타날 수 있음

• 현재 구현은 이메일 작업에 중점을 둠

Microsoft Graph를 사용하지 않는 이유는?

Microsoft Graph는 최신 Microsoft 365 환경에 탁월한 옵션입니다.

이 프로젝트는 다른 사용 사례, 즉 레거시 데스크톱 Outlook을 대상으로 합니다.

Outlook 2007 또는 최신 Outlook/Graph 기반 통합을 사용할 수 없거나 실용적이지 않은 다른 레거시 환경을 사용 중이라면, 이 프로젝트는 로컬 COM 기반 MCP 브리지를 제공합니다.

아키텍처

서버는 Python, pywin32, Outlook COM 자동화, MCP Python SDK를 사용합니다.

MCP 서버는 COM을 통해 Outlook 애플리케이션을 가져와 해당 MAPI 네임스페이스에 접근합니다. 따라서 별도의 메일 서버 인증 흐름을 구현하는 대신 컴퓨터에 이미 구성된 Outlook 프로필을 사용합니다.

개발

의존성을 설치합니다:

pip install -r requirements.txt

서버를 실행합니다:

python outlook_mcp_server.py

서버는 Claude Desktop과 같은 MCP 호환 클라이언트에 의해 실행되도록 설계되었습니다.

기여

이슈, 개선 사항, 호환성 보고서, 풀 리퀘스트를 환영합니다.

다른 레거시 Outlook 버전으로 프로젝트를 테스트한 경우, 이슈에 Outlook 버전과 Windows 버전을 포함해 주세요.

라이선스

MIT 라이선스. LICENSE를 참조하세요.