Outlook Web MCP server (unofficial)

ローカルの Outlook COM を、Outlook Web が内部利用している非公開 API に置き換える MCP サーバーです。Microsoft Graph、Outlook デスクトップ、COM、ブラウザー Cookie は 使いません。

COM 版との互換性

COM 版のツール名と主要な引数・戻り値を維持しています。

認証状態確認用に outlook_auth_status も追加しています。送信、削除、移動、アーカイブの ツールは意図的に実装していません。storeId は COM の Store Entry ID ではなく、 このサーバー専用の outlook-web です。検索結果から返された値をそのまま使ってください。

Related MCP server: Playwright MCP

セットアップ

Python 3.11 以上と uv が必要です。

uv sync --dev
uv run outlook-web-mcp login
uv run outlook-web-mcp probe

初回ログインでは Microsoft のデバイスコード画面が開きます。アクセストークンはメモリ内 だけで扱い、更新トークンは OS の資格情報保管庫に保存します。標準出力や MCP 応答に トークンを出しません。

サインインを別工程に分けたい場合:

uv run outlook-web-mcp login-start
# 表示されたコードでサインイン後
uv run outlook-web-mcp login-complete

MCP への登録

stdio サーバーの起動コマンドは次です。

uv run outlook-web-mcp-server

クライアント設定例（パスはこのリポジトリの絶対パスへ変更）:

{
  "mcpServers": {
    "outlook-web": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\outlook-web-teams-un-oficial-api",
        "run",
        "outlook-web-mcp-server"
      ]
    }
  }
}

COM 版から切り替える

1. uv run outlook-web-mcp login でこのサーバー専用の認証を1回行う。

2. MCP クライアントの outlook-com 起動設定を、上記 outlook-web の設定へ置き換える。

3. MCP クライアントを再起動し、outlook_auth_status と search_emails で確認する。

ツール名と引数名は維持していますが、COM 版で以前取得した emailId、folderId、 storeId は再利用できません。Web 版の検索・フォルダー一覧から ID を取り直してください。

CLI

outlook-web-mcp login          # 対話ログイン
outlook-web-mcp login-start    # デバイスコードを発行
outlook-web-mcp login-complete # 発行済みコードのログインを完了
outlook-web-mcp status         # 秘密を含まない認証状態
outlook-web-mcp probe          # メール内容を取得しない Inbox 疎通確認
outlook-web-mcp logout         # 保存済み資格情報を削除
outlook-web-mcp serve          # stdio MCP を起動

設定

必要な場合だけ環境変数で上書きします。

OUTLOOK_WEB_CLIENT_ID も変更できますが、既定値は Outlook Web が公開ログイン画面で使う ファーストパーティー クライアント ID です。組織の条件付きアクセスや同意ポリシーによって 認証できない場合があります。

開発時の確認

uv run pytest
uv run ruff check .
uv run mypy
uv build

内部 API の調査結果と設計上の境界は docs/internal-api.md にあります。