Microsoft Outlook のメール機能へのアクセスを提供するモデルコンテキストプロトコル (MCP) サーバー, LLM や他の MCP クライアントが標準インターフェイスを使用してメールを読み、検索、管理できるようにします。.

##特徴

• フォルダー管理: Outlook クライアントで利用可能なメールフォルダーをリスト -メールリスト:指定された期間からのメールを取得します
• 電子メール検索: 連絡先名、キーワード、または OR 演算子でメールを検索する -メールの詳細:添付ファイルを含む完全なメールコンテンツを表示
• 電子メール構成: 新しいメールの作成と送信
• 電子メール返信:既存のメールに返信

前提条件

• Windowsのオペレーティング システム
• Python 3.10以降
• Microsoft Outlook がインストールされ、アクティブなアカウントで設定
• Claudeデスクトップまたは別のMCP互換クライアント

インストール

1. 本リポジトリのクローンまたはダウンロード

2. 必要な依存関係を取付けて下さい:

3. このサーバーを使用するためにClaudeデスクトップ(またはお好みのMCPクライアント)を構成する

設定

##Claudeデスクトップの設定

MCP_client_config.json ファイルに次のを追加します。

使用法

サーバーの起動

サーバを直接起動できます

Outlook MCP Server

A Model Context Protocol (MCP) server that provides access to Microsoft Outlook email functionality, allowing LLMs and other MCP clients to read, search, and manage emails through a standardized interface.

Features

• Folder Management: List available mail folders in your Outlook client
• Email Listing: Retrieve emails from specified time periods
• Email Search: Search emails by contact name, keywords, or phrases with OR operators
• Email Details: View complete email content, including attachments
• Email Composition: Create and send new emails
• Email Replies: Reply to existing emails

Prerequisites

• Windows operating system
• Python 3.10 or later
• Microsoft Outlook installed and configured with an active account
• Claude Desktop or another MCP-compatible client

Installation

1. Clone or download this repository
2. Install required dependencies:

pip install mcp>=1.2.0 pywin32>=305

3. Configure Claude Desktop (or your preferred MCP client) to use this server

Configuration

Claude Desktop Configuration

Add the following to your MCP_client_config.json file:

{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["Your path\\outlook_mcp_server.py"],
      "env": {}
    }
  }
}

Usage

Starting the Server

You can start the server directly:

python outlook_mcp_server.py

Or allow an MCP client like Claude Desktop to start it via the configuration.

Available Tools

The server provides the following tools:

1. list_folders: Lists all available mail folders in Outlook
2. list_recent_emails: Lists email titles from the specified number of days
3. search_emails: Searches emails by contact name or keyword
4. get_email_by_number: Retrieves detailed content of a specific email
5. reply_to_email_by_number: Replies to a specific email
6. compose_email: Creates and sends a new email

Example Workflow

1. Use list_folders to see all available mail folders
2. Use list_recent_emails to view recent emails (e.g., from last 7 days)
3. Use search_emails to find specific emails by keywords
4. Use get_email_by_number to view a complete email
5. Use reply_to_email_by_number to respond to an email

Examples

Listing Recent Emails

Could you show me my unread emails from the last 3 days?

Searching for Emails

Search for emails about "project update OR meeting notes" in the last week

Reading Email Details

Show me the details of email #2 from the list

Replying to an Email

Reply to email #3 with: "Thanks for the information. I'll review this and get back to you tomorrow."

Composing a New Email

Send an email to [email protected] with subject "Meeting Agenda" and body "Here's the agenda for our upcoming meeting..."

Troubleshooting

• Connection Issues: Ensure Outlook is running and properly configured