Outlook-Mail-MCP

집 컴퓨터를 위한 초경량 이메일 MCP: Outlook 계정 하나를 연결하여 이메일을 읽고 회신합니다.

🤝 Lynn & Sage(ChatGPT) 공동 제작

이 프로젝트는 Lynn과 Sage(ChatGPT)가 함께 설계, 구현, 디버깅했습니다.

이 프로젝트는 세 가지만 합니다:

• 📬 최근 이메일 확인

• 📖 이메일 읽기

• ↩️ 이메일 회신

달력, 클라우드 저장소, Power Automate, 다중 계정 관리는 하지 않습니다.

적용 방안

본 방안은 Render Web Service + Microsoft Outlook / Microsoft Graph + OAuth 2.0 을 주요 배포 방식으로 삼아, 이메일 기능을 원격 MCP 서비스로 집 컴퓨터에 제공하기에 적합합니다.

Node.js, HTTPS 및 영구 토큰 저장을 지원하는 모든 환경에서 실행할 수 있지만, 프로젝트 기본 구성과 배포 파일은 Render를 기준으로 합니다.

Related MCP server: outlook-mcp

사용 방법

Render에 배포한 후 서비스 홈페이지를 열고 Outlook 사서함 연결을 클릭하여 Microsoft 로그인 및 인증을 완료합니다.

인증이 완료되면 MCP 주소 https://你的服务地址/mcp 를 집 컴퓨터에 연결하면 됩니다.

Microsoft 설정

Microsoft Entra / Azure App Registration에서 앱을 만들고 다음 Delegated permissions를 활성화합니다:

• openid

• profile

• offline_access

• User.Read

• Mail.Read

• Mail.ReadWrite

• Mail.Send

Redirect URI는 다음을 사용합니다:

https://你的服务地址/auth/callback

앱 유형은 Web을 선택합니다.

환경 변수

MS_CLIENT_ID=你的 Application (client) ID
MS_CLIENT_SECRET=你的 Client Secret VALUE
MS_TENANT_ID=common
TOKEN_DIR=/data

Render에서는 서버가 PUBLIC_URL을 우선적으로 사용하고, 그렇지 않으면 Render가 자동으로 제공하는 RENDER_EXTERNAL_URL을 사용하여 OAuth 콜백 주소를 생성합니다.

Render 배포

리포지토리에는 이미 render.yaml이 포함되어 있어 Render Blueprint로 바로 배포할 수 있습니다.

Render 구성은 다음을 포함합니다:

• Node.js Web Service

• /health 상태 확인

• 1 GB 영구 디스크

• /data 토큰 저장 디렉터리

• Microsoft OAuth에 필요한 환경 변수

토큰은 Render 영구 디스크에 저장되며 GitHub에 커밋되지 않습니다.

MCP 도구

로컬 실행

npm install
npm start

기본 주소: http://localhost:3000/.

로컬 OAuth 콜백: http://localhost:3000/auth/callback.

보안

OAuth 비밀번호는 집 컴퓨터에 전달되지 않습니다. Microsoft 로그인이 완료되면 서비스는 OAuth 토큰만 저장하며, 토큰 파일 권한은 현재 프로세스 사용자만 읽고 쓸 수 있도록 설정됩니다.

Credits

Lynn × Sage(ChatGPT)
한 명의 인간 개발자 + 한 명의 AI 파트너가 함께 이 작은 도구를 만들어 냈습니다. 🫳