MCP Outlook Tools

🚀 MCP Outlook Tools

Model Context Protocol (MCP)サーバーの実装で、AIアシスタントがMicrosoft Outlookとやり取りして、カレンダー管理、メール操作、検索機能を行うことができます。

🚀 クイックスタート

このツールは、AIアシスタントがMicrosoft Outlookと連携してカレンダー管理やメール操作を行うためのMCPサーバー実装です。以下の手順に従ってセットアップしてください。

✨ 主な機能

• 📅 カレンダー管理

  • 指定した日付範囲内のカレンダーアイテムを取得します。
  • 詳細情報を含む新しい予定を追加します。
  • カテゴリと忙しさのステータスをサポートします。

• 📧 メール操作

  • To/CCの受信者を指定してメールを送信します。
  • 送信前に確認画面を表示します。
  • 本文の完全な書式設定をサポートします。

• 🔍 メール検索

  • 日付とキーワードでメールを検索します。
  • アドレスからユーザー情報を抽出します。
  • 日本語のテキストエンコーディングをサポートします。

📦 インストール

必要条件

• Windows OS (pywin32のために必要)
• Microsoft Outlookがインストールされ、設定されていること
• Python 3.10以上
• MCP互換のAIアシスタント (例: Claude Desktop)

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/wmoto-ai/mcp-outlook-tools.git
cd mcp-outlook-tools

2. uvを使用して依存関係をインストールします。

uv pip install -e .

または、pipを使用してインストールします。

pip install -e .

📚 ドキュメント

設定

Claude Desktopの場合

Claude Desktopの設定ファイルに以下を追加してください。

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "outlook-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/path/to/mcp-outlook-tools",
        "run",
        "--with-editable",
        ".",
        "-m",
        "outlook_tools.server"
      ],
      "cwd": "C:/path/to/mcp-outlook-tools",
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

使用方法

設定が完了すると、AIアシスタントで以下のツールが使用できます。

add_appointment

Outlookカレンダーに新しい予定を追加します。
パラメータ:
- subject: 予定のタイトル
- start_time: 開始日時 (YYYY-MM-DD HH:MM)
- end_time: 終了日時 (YYYY-MM-DD HH:MM)
- location: 会議場所 (オプション)
- description: 詳細な説明 (オプション)
- categories: カンマ区切りのカテゴリ (オプション)
- busy_status: 0=空き、1=仮予定、2=忙しい、3=外出中 (デフォルト: 1)

get_calendar

指定した日付範囲のカレンダーアイテムを取得します。
パラメータ:
- start_date: 開始日 (YYYY-MM-DD)
- end_date: 終了日 (YYYY-MM-DD)

send_email

Outlookを介してメールを送信します。
パラメータ:
- to: 受信者のメールアドレス (セミコロン区切り)
- cc: CCの受信者 (セミコロン区切り)
- subject: メールの件名
- body: メールの本文

プロジェクト構造

mcp-outlook-tools/
├── src/
│   └── outlook_tools/
│       ├── __init__.py
│       ├── server.py           # MCPサーバーの実装
│       ├── calendar_service.py # カレンダー操作
│       └── search_service.py   # メール検索操作
├── test/                       # テストファイル
├── pyproject.toml             # プロジェクト設定
└── README.md                  # このファイル

開発

テストの実行

pytest test/

型チェック

pyright src/

リンティング

ruff check src/

🔧 技術詳細

• このツールは、ローカルのOutlookインストールにアクセスする必要があります。
• メールは送信前にユーザーの確認のために表示されます。
• コード内には資格情報は保存されません。
• すべての操作は、既存のOutlook認証を使用したWindows COMインターフェイスを利用しています。

⚠️ 制限事項

• pywin32の依存関係のため、Windowsのみで動作します。
• Outlookがインストールされ、設定されている必要があります。
• タイムゾーンの処理はJST (+9時間)を前提としています。

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• FastMCPフレームワークを使用して構築されています。
• Outlook COMインターフェイスにはpywin32を使用しています。