WorkMail MCP サーバー

Claude Desktop を Amazon WorkMail に接続し、安全なローカル stdio トランスポート経由でメールおよびカレンダーへのアクセスを提供する Model Context Protocol (MCP) サーバーです。

機能

Related MCP server: Gmail & Calendar Multi-Account MCP Server

セキュリティ

• 認証情報は macOS キーチェーン（Apple Silicon 上ではハードウェア暗号化）に保存され、設定ファイルや環境変数には決して保存されません

• トランスポートには stdio（ローカルパイプ）を使用 — HTTP サーバーやオープンポートは使用しません

• WorkMail EWS エンドポイントへの HTTPS/TLS による通信の暗号化

• Zod スキーマによるすべてのツール呼び出しの入力検証

• 出力のサニタイズにより、すべてのレスポンスおよびエラーメッセージから認証情報の値を削除

• レート制限により、無限ループのリクエストを防止（設定可能、デフォルトは 30回/分）

• 書き込み保護 — send_email および create_calendar_event には confirm: true パラメータが必要

前提条件

• macOS（認証情報の保存にキーチェーンを使用）

• Node.js 20 以上

• ユーザー名/パスワード認証を使用する Amazon WorkMail アカウント

セットアップ

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

git clone https://github.com/your-username/workmail-mcp-server.git
cd workmail-mcp-server
npm install

2. 環境設定

cp .env.example .env

WorkMail が別のリージョンにある場合は .env を編集してください：

WORKMAIL_MCP_EWS_ENDPOINT=https://ews.mail.us-west-2.awsapps.com/EWS/Exchange.asmx

EWS エンドポイントは https://ews.mail.<region>.awsapps.com/EWS/Exchange.asmx というパターンに従います。一般的なリージョン：us-east-1、us-west-2、eu-west-1。

3. 認証情報の保存

npm run setup-credentials

これにより、WorkMail のメールアドレスとパスワードの入力を求められ、macOS キーチェーンに保存され、接続が検証されます。

4. ビルド

npm run build

5. Claude Desktop への登録

Claude Desktop の設定ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) に以下を追加します：

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

Claude Desktop を再起動します。WorkMail サーバーが接続済みとして表示されるはずです。

設定

すべての設定はオプションであり、適切なデフォルト値が設定されています。.env または環境変数として設定してください：

claude_desktop_config.json で設定された環境変数は .env よりも優先されます。

使用方法

接続後、Claude Desktop に WorkMail との対話を依頼してください：

• 「最近のメールを一覧表示して」

• 「Sarah からの Q3 レポートに関するメールを読んで」

• 「受信トレイからデプロイメントに関するメッセージを検索して」

• 「今週の予定は？」

• 「team@example.com にステータス更新についてのメールを送って」

• 「明日午後2時に Alex との会議を作成して」

開発

# Run directly from TypeScript (no build step)
npm run dev

# Rebuild after changes
npm run build

# Re-run credential setup
npm run setup-credentials

ログは JSON 形式で stderr に書き込まれます。Claude Desktop 経由で実行中にこれを確認するには、Claude Desktop の開発者ツールで MCP サーバーのログを確認してください。

アーキテクチャ

Claude Desktop  <──stdio──>  MCP Server (Node.js)
                                  │
                                  ▼
                            EWS Client Layer
                                  │
                                  ▼
                  Amazon WorkMail (Exchange Web Services)

このサーバーは、Amazon WorkMail がサポートするバージョンである Exchange2010_SP2 互換レベルの EWS プロトコルを使用しています。

ライセンス

MIT