cam10001110101/mcp-server-outlook-email

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

14 stars 11 forks 品質 60 トレンド 20

Repository Install

Microsoft Outlook のメールを処理するクロスプラットフォーム MCP サーバー, Ollama を使用してベクトル埋め込みを生成します。, 意味のある検索機能を提供します。. 、および.

概要

Microsoft Outlook のメールを処理するクロスプラットフォーム MCP サーバー, Ollama を使用してベクトル埋め込みを生成します。, 意味のある検索機能を提供します。. 、および。サーバは、公式のMCP SDKに準拠し、使用しています。 - 日付範囲のフィルタリングでOutlookからのプロセスメール - 適切な接続管理でSQLiteデータベースにメールを保存 - Ollama(nomic-embed-text)を使用してベクトル埋め込みを生成 - MongoDBのベクトルストアを介して電子メールコンテンツを横断検索 - マルチメールボックスとマルチアカウントのサポート - Inboxのサポート、Sentアイテム、およびオプションで削除されたアイテムフォルダ - : pywin32によるネイティブOutlook COM自動化 - : Mac用のOutlookとAppleScriptの統合 - : クラウドベースのアクセスのためのMicrosoft Graph API (Windows、macOS、Linux、コンテナ) - : ツールは正しく入力され、検証されたPydanticモデルを返す - : STDIOとHTTP(Streamable HTTP)の両方の転送をサポート - : ハンドシェイク中にプロトコルバージョンを宣言 - : ツールのタイトルとより良いUIのための説明...

概要（AI 翻訳）

Microsoft Outlook のメールを処理するクロスプラットフォーム MCP サーバー, Ollama を使用してベクトル埋め込みを生成します。, 意味のある検索機能を提供します。. Microsoft Graph API 経由でWindows、macOS、**その他のプラットフォームで動作します。

サーバは、Model Context Protocol (MCP) 2025-06-18 仕様 に準拠し、公式 MCP SDK を使用します。

##特徴

コア機能

日付範囲のフィルタリングでOutlookからのプロセスメール
適切な接続管理でSQLiteデータベースにメールを保存
Ollama(nomic-embed-text)を用いたベクトル埋め込みを生成する
MongoDBベクターストアでメールコンテンツを横断検索
マルチメールボックスとマルチアカウントのサポート
受信トレイ、送信アイテム、およびオプションで削除されたアイテムフォルダのサポート

クロスプラットフォームのサポート

-Windows: ネイティブOutlook COM による自動化 pywin32

macOS: Mac用のOutlookとAppleScriptの統合 -Any Platform:クラウドベースのアクセス(Windows、macOS、Linux、コンテナ)用のMicrosoft Graph API

MCP 2025-06-18 コンプライアンス

厳格なツール結果: ツールは正しく入力され、検証されたPydanticモデルを返します -HTTP Transport:STDIOとHTTP(Streamable HTTP)の両方の転送をサポート

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Email Processing MCP Server

A cross-platform MCP server that processes Microsoft Outlook emails, generates vector embeddings using Ollama, and provides semantic search capabilities. Works on Windows, macOS, and any platform via Microsoft Graph API.

The server complies with the Model Context Protocol (MCP) 2025-06-18 specification and uses the official MCP SDK.

Features

Core Capabilities

Process emails from Outlook with date range filtering
Store emails in SQLite database with proper connection management
Generate vector embeddings using Ollama (nomic-embed-text)
Semantic search across email content via MongoDB vector store
Multi-mailbox and multi-account support
Support for Inbox, Sent Items, and optionally Deleted Items folders

Cross-Platform Support

Windows: Native Outlook COM automation via pywin32
macOS: AppleScript integration with Outlook for Mac
Any Platform: Microsoft Graph API for cloud-based access (Windows, macOS, Linux, containers)

MCP 2025-06-18 Compliance

Structured Tool Results: Tools return properly typed, validated Pydantic models
HTTP Transport: Supports both STDIO and HTTP (Streamable HTTP) transports
Protocol Negotiation: Declares protocol version during handshake
Enhanced Metadata: Tool titles and descriptions for better UI integration

Available Tools (12+)

Category	Tools
Email Processing	`process_emails`
Search & Analysis	`search_emails`, `analyze_email_sentiment`, `find_actionable_items`
Data Export	`export_email_data` (CSV, JSON, HTML, Excel)
Folder Management	`list_outlook_folders`, `get_folder_statistics`, `organize_emails_by_rules`
Contact Management	`extract_contacts`
Statistics	`get_email_statistics`, `check_data_consistency`

Prerequisites

Required (All Platforms)

Python 3.10 or higher
Ollama running locally with nomic-embed-text model
MongoDB server (for storing embeddings)

Platform-Specific Requirements

Platform	Requirement
Windows	Microsoft Outlook installed + pywin32
macOS	Microsoft Outlook for Mac installed
Graph API	Azure AD app registration with Mail.Read permission

Installation

1. Install uv (if not already installed)

pip install uv

2. Create and activate virtual environment

uv venv .venv

# Windows
.venv\Scripts\activate

# macOS/Linux
source .venv/bin/activate

3. Install dependencies

Core installation (required):

uv pip install -e .

Platform-specific extras:

# Windows (adds pywin32 for COM automation)
uv pip install -e ".[windows]"

# Graph API support (cross-platform cloud access)
uv pip install -e ".[graph]"

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "outlook-email": {
      "command": "C:/path/to/.venv/Scripts/python",
      "args": ["C:/path/to/src/mcp_server.py"],
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017/MCP?authSource=admin",
        "SQLITE_DB_PATH": "C:\\path\\to\\data\\emails.db",
        "EMBEDDING_BASE_URL": "http://localhost:11434",
        "EMBEDDING_MODEL": "nomic-embed-text",
        "COLLECTION_NAME": "outlook-emails",
        "OUTLOOK_PROVIDER": "windows",
        "LOCAL_TIMEZONE": "America/Chicago"
      }
    }
  }
}