Outlook MCP Server

# Outlook MCP Server Microsoft Graph APIを使用してOutlookメールにアクセスするためのModel Context Protocol (MCP)サーバーです。 ## 機能 - Outlookメールの一覧取得 - メールの詳細取得 - メール検索 - 既読/未読の切り替え - メール削除 ## セットアップ ### 1. 依存関係のインストール ```bash npm install ``` ### 2. ビルド ```bash npm run build ``` ## 使用方法 ### Stdio Transport（ローカル使用） ```bash npm start ``` ### HTTP/SSE Transport（リモートMCP用） ```bash node dist/http-server.js ``` サーバーは`http://localhost:3000`で起動します。 MCPエンドポイント: `http://localhost:3000/mcp` ## アクセストークンの取得 Microsoft Graph APIのアクセストークンが必要です。以下の方法で取得できます： 1. [Microsoft Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer)にアクセス 2. Microsoftアカウントでサインイン 3. 「Access token」タブからトークンをコピー ## MCP設定例 ### Claude Desktopでの設定 (stdio) `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "outlook": { "command": "node", "args": ["/path/to/outlook-mcp/dist/index.js"] } } } ``` ### HTTP Transport設定 ```json { "mcpServers": { "outlook": { "transport": "http", "url": "http://localhost:3000/mcp" } } } ``` ## 利用可能なツール ### 1. set_access_token Microsoft Graph APIのアクセストークンを設定します。 ### 2. list_emails メール一覧を取得します。 - `top`: 取得するメール数（デフォルト: 10） - `skip`: スキップするメール数（ページネーション用） - `filter`: ODataフィルタクエリ（例: "isRead eq false"） - `orderBy`: 並び順（デフォルト: "receivedDateTime DESC"） - `search`: 検索クエリ ### 3. get_email 特定のメールの詳細を取得します。 - `message_id`: メールID（必須） ### 4. search_emails メールを検索します。 - `query`: 検索クエリ（必須） - `top`: 最大結果数（デフォルト: 10） ### 5. mark_as_read メールを既読/未読にします。 - `message_id`: メールID（必須） - `is_read`: true（既読）またはfalse（未読） ### 6. delete_email メールを削除します。 - `message_id`: メールID（必須） ## 開発 ```bash npm run dev ``` TypeScriptの変更を監視して自動的に再起動します。