ryaker/outlook-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Microsoft Graph API를 통해 Outlook 데이터를 접근하는 Claude용 MCP 서버
개요
Microsoft Graph API와 Power Automate API를 통해 Claude를 Microsoft 365 서비스와 연결하는 포괄적인 MCP(모델 컨텍스트 프로토콜) 서버입니다. - - 이메일, 캘린더, 폴더, 규칙 - - 파일, 폴더, 검색 및 공유 - - 플로우, 환경, 실행 기록 - : Microsoft Graph API (+ Power Automate용 플로우 API) OAuth 2.0 인증 - : 이메일 목록, 검색, 읽기, 전송, 조직 - : 일정 이벤트 목록, 생성, 수락, 거부, 삭제 - : 파일 목록, 검색, 업로드, 다운로드, 공유 - : 환경/흐름 목록, 트리거 플로우, 실행 기록 보기 - : 유지보수 가능성을 위한 관심사 분리 - : 실제 API 호출 없이 테스트용 시뮬레이션 응답 1. : npm 설치 2. : Azure 포털에서 앱 등록하기(아래 자세한 단계 참조) 3. : .env.example을 .env로 복사하고 Azure 자격 증명을 추가하세요 4. : Claude 데스크탑 설정을 서버 경로로 업데이트하세요 5. : npm auth-server 실행하기 6. : Claude의 인증 도구를 사용해 OAuth URL을 받으세요.
개요(AI 번역)
Microsoft Graph API와 Power Automate API를 통해 Claude를 Microsoft 365 서비스와 연결하는 포괄적인 MCP(모델 컨텍스트 프로토콜) 서버입니다.
지원 서비스
- Outlook - 이메일, 캘린더, 폴더, 규칙
- OneDrive - 파일, 폴더, 검색 및 공유
- Power Automate - 흐름, 환경, 실행 기록
디렉토리 구조
특징
- 인증: Microsoft Graph API (+ Power Automate용 Flow API)를 이용한 OAuth 2.0 인증입니다
- 이메일 관리: 이메일 목록, 검색, 읽기, 전송 및 조직
- 캘린더 관리: 캘린더 이벤트 목록, 생성, 수락, 거부, 삭제
- OneDrive 통합: 파일 목록, 검색, 업로드, 다운로드 및 공유
- Power Automate: 환경/플로우 목록, 트리거 플로우, 실행 기록 보기
- 모듈러 구조: 유지보수 가능성을 위한 관심사의 깔끔한 분리
- 테스트 모드: 실제 API 호출 없이 테스트하기 위한 시뮬레이션 응답
사용 가능한 도구
전망 (이메일 및 캘린더)
| 도구 | 설명 |
|---|---|
list-emails |
받은 편지함에서 최근 이메일 목록 |
search-emails |
필터가 있는 이메일 검색 |
read-email |
이메일 내용 읽기 |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
M365 Assistant MCP Server
A comprehensive MCP (Model Context Protocol) server that connects Claude with Microsoft 365 services through the Microsoft Graph API and Power Automate API.
Supported Services
- Outlook - Email, calendar, folders, and rules
- OneDrive - Files, folders, search, and sharing
- Power Automate - Flows, environments, and run history
Directory Structure
├── index.js # Main entry point
├── config.js # Configuration settings
├── auth/ # Authentication modules
│ ├── index.js # Authentication exports
│ ├── token-manager.js # Token storage and refresh (Graph + Flow)
│ └── tools.js # Auth-related tools
├── calendar/ # Calendar functionality
│ ├── index.js # Calendar exports
│ ├── list.js # List events
│ ├── create.js # Create event
│ ├── delete.js # Delete event
│ ├── cancel.js # Cancel event
│ ├── accept.js # Accept event
│ └── decline.js # Decline event
├── email/ # Email functionality
│ ├── index.js # Email exports
│ ├── list.js # List emails
│ ├── search.js # Search emails
│ ├── read.js # Read email
│ ├── send.js # Send email
│ └── mark-as-read.js # Mark email read/unread
├── folder/ # Folder functionality
│ ├── index.js # Folder exports
│ ├── list.js # List folders
│ ├── create.js # Create folder
│ └── move.js # Move emails
├── rules/ # Email rules functionality
│ ├── index.js # Rules exports
│ ├── list.js # List rules
│ └── create.js # Create rule
├── onedrive/ # OneDrive functionality
│ ├── index.js # OneDrive exports
│ ├── list.js # List files/folders
│ ├── search.js # Search files
│ ├── download.js # Get download URL
│ ├── upload.js # Simple upload (<4MB)
│ ├── upload-large.js # Chunked upload (>4MB)
│ ├── share.js # Create sharing link
│ └── folder.js # Create/delete folders
├── power-automate/ # Power Automate functionality
│ ├── index.js # Power Automate exports
│ ├── flow-api.js # Flow API client
│ ├── list-environments.js # List environments
│ ├── list-flows.js # List flows
│ ├── run-flow.js # Trigger flow
│ ├── list-runs.js # Run history
│ └── toggle-flow.js # Enable/disable flow
└── utils/ # Utility functions
├── graph-api.js # Microsoft Graph API helper
├── odata-helpers.js # OData query building설치
npx kill-port 3333설정
{
"mcpServers": {
"m365-assistant": {
"command": "node",
"args": ["/path/to/outlook-mcp/index.js"],
"env": {
"USE_TEST_MODE": "false",
"OUTLOOK_CLIENT_ID": "your-client-id",
"OUTLOOK_CLIENT_SECRET": "your-client-secret"
}
}
}
}