Outlook MCP Server

Microsoft Graph APIを使用してOutlookメールにアクセスするためのModel Context Protocol (MCP)サーバーです。

機能

• Outlookメールの一覧取得
• メールの詳細取得
• メール検索
• 既読/未読の切り替え
• メール削除

セットアップ

1. 依存関係のインストール

npm install

2. ビルド

npm run build

使用方法

Stdio Transport（ローカル使用）

npm start

HTTP/SSE Transport（リモートMCP用）

node dist/http-server.js

サーバーはhttp://localhost:3000で起動します。 MCPエンドポイント: http://localhost:3000/mcp

アクセストークンの取得

Microsoft Graph APIのアクセストークンが必要です。以下の方法で取得できます：

1. Microsoft Graph Explorerにアクセス
2. Microsoftアカウントでサインイン
3. 「Access token」タブからトークンをコピー

MCP設定例

Claude Desktopでの設定 (stdio)

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "outlook": {
      "command": "node",
      "args": ["/path/to/outlook-mcp/dist/index.js"]
    }
  }
}

HTTP Transport設定

{
  "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（必須）

開発

npm run dev

TypeScriptの変更を監視して自動的に再起動します。