Claude Outlook MCP Tool

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Used as the JavaScript runtime to execute the MCP server code.

  • Required as the operating system environment for running the MCP tool with macOS-specific Outlook integration.

클로드 아웃룩 MCP 도구

이는 Claude가 macOS용 Microsoft Outlook과 상호 작용할 수 있게 해주는 MCP(Model Context Protocol) 도구입니다.

특징

  • 우편:
    • 읽지 않은 이메일과 일반 이메일을 읽어보세요
    • 키워드로 이메일 검색
    • 받는 사람, 참조, 숨은 참조 수신자에게 이메일을 보냅니다.
    • HTML 형식의 이메일 보내기
    • 이메일에 파일 첨부
    • 메일 폴더 나열
  • 달력:
    • 오늘의 이벤트 보기
    • 예정된 이벤트 보기
    • 이벤트 검색
    • 새 캘린더 이벤트 만들기
  • 콘택트 렌즈:
    • 연락처 목록
    • 이름으로 연락처 검색

필수 조건

설치

  1. 이 저장소를 복제하세요:

지엑스피1

  1. 종속성 설치:
bun install
  1. 스크립트가 실행 가능한지 확인하세요.
chmod +x index.ts
  1. Claude Desktop 구성을 업데이트하세요.

~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 claude_desktop_config.json 파일을 편집하여 이 도구를 포함시킵니다.

{ "mcpServers": { "outlook-mcp": { "command": "/Users/YOURUSERNAME/.bun/bin/bun", "args": ["run", "/path/to/claude-outlook-mcp/index.ts"] } } }

YOURUSERNAME 실제 macOS 사용자 이름으로 바꾸고 이 저장소를 복제한 경로로 경로를 조정하세요.

  1. Claude Desktop 앱을 다시 시작하세요
  2. 권한 부여:
    • 시스템 환경 설정 > 개인 정보 보호 및 보안 > 개인 정보 보호로 이동하세요.
    • 터미널(또는 선호하는 터미널 앱)에 접근성 기능 액세스 권한 부여
    • 도구를 처음 사용할 때 권한 요청 메시지가 표시될 수 있습니다.

용법

설치가 완료되면 다음과 같은 질문을 통해 Claude에서 직접 Outlook 도구를 사용할 수 있습니다.

  • "Outlook에서 읽지 않은 이메일을 확인할 수 있나요?"
  • "분기별 보고서를 위해 Outlook 이메일을 검색하세요"
  • " john@example.com 으로 '내일 회의'라는 제목으로 이메일을 보내세요."
  • "오늘 내 일정에는 무슨 일이 있나요?"
  • "내일 오후 2시에 회의를 만들어주세요"
  • "제인 스미스의 연락처 정보를 찾으세요"

예시

이메일 운영

Check my unread emails in Outlook
Send an email to alex@example.com with subject "Project Update" and the following body: Here's the latest update on our project. We've completed phase 1 and are moving on to phase 2.
Send an HTML email to team@example.com with subject "Weekly Report" and attach the quarterly_results.pdf file
Search my emails for "budget meeting"

캘린더 작업

What events do I have today?
Create a calendar event for a team meeting tomorrow from 2pm to 3pm
Show me my upcoming events for the next 2 weeks

연락처 운영

List all my Outlook contacts
Search for contact information for Jane Smith

고급 기능

HTML 이메일 지원

isHtml 매개변수를 true로 설정하면 풍부한 HTML 형식의 이메일을 보낼 수 있습니다.

Send an HTML email to john@example.com with the subject "Project Update" and body "<h1>Project Update</h1><p>We've made <b>significant progress</b> on the project.</p>"

파일 첨부

attachments 매개변수에 파일 경로를 제공하여 이메일에 파일을 첨부할 수 있습니다.

Send an email to jane@example.com with subject "Monthly Report" and attach the reports/march_2025.pdf file

첨부 파일을 사용하여 최상의 결과를 얻으려면:

  • 가능하면 절대 파일 경로를 사용하세요
  • MCP 도구를 실행하는 프로세스에서 파일에 액세스할 수 있는지 확인하세요.
  • 첨부 파일은 강력한 오류 감지 기능을 통해 자동으로 처리됩니다.

문제 해결

첨부 파일에 문제가 발생하는 경우:

  • 파일이 존재하고 읽을 수 있는지 확인하세요
  • 상대 경로 대신 절대 파일 경로를 사용하세요
  • 프로세스를 실행하는 사용자에게 파일을 읽을 수 있는 권한이 있는지 확인하세요.

Cannot find module '@modelcontextprotocol/sdk/server/index.js' 오류가 발생하는 경우:

  1. 모든 종속성을 설치하려면 bun install 실행했는지 확인하세요.
  2. MCP SDK를 명시적으로 설치해보세요.
    bun add @modelcontextprotocol/sdk@^1.5.0
  3. 모듈이 node_modules 디렉토리에 있는지 확인하세요.
    ls -la node_modules/@modelcontextprotocol/sdk/server/

오류가 지속되면 Bun으로 새 프로젝트를 만들어 보세요.

mkdir -p ~/yourpath/claude-outlook-mcp cd ~/yourpath/claude-outlook-mcp bun init -y

그런 다음 package.json 및 index.ts 파일을 새 디렉토리에 복사하고 실행합니다.

bun install bun run index.ts

claude_desktop_config.json을 업데이트하여 새로운 위치를 가리키도록 합니다.

특허

MIT

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Claude가 macOS용 Microsoft Outlook과 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 도구로, 사용자는 자연어 명령을 통해 이메일을 읽고 보내고, 일정 이벤트를 관리하고, 연락처에 액세스할 수 있습니다.

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Examples
            1. Email Operations
            2. Calendar Operations
            3. Contact Operations
          2. Advanced Features
            1. HTML Email Support
            2. File Attachments
          3. Troubleshooting
            1. License
              ID: 0j71n92wnh