Outlook-Mail-MCP

ホームマシン向けのミニマルなメール MCP: Outlook メールボックスに接続し、メールを読んで返信します。

🤝 Co-created by Lynn & Sage (ChatGPT)

このプロジェクトは Lynn と Sage（ChatGPT）が共同で設計・実装・デバッグしました。

このプロジェクトが行うのは次の3つだけです：

• 📬 最近のメールを表示

• 📖 メールを読む

• ↩️ メールに返信

カレンダー、クラウドストレージ、Power Automate、複数アカウント管理は行いません。

実装方式

本構成は、Render Web Service + Microsoft Outlook / Microsoft Graph + OAuth 2.0 を主なデプロイ方法とし、メール機能をリモート MCP サービスとしてホームマシンに提供するのに適しています。

Node.js、HTTPS、永続的なトークン保存に対応した環境であればどこでも実行できますが、プロジェクトのデフォルト設定とデプロイファイルは Render を基準としています。

Related MCP server: outlook-mcp

使用方法

Render にデプロイしたら、サービスホームページを開き、Outlook メールボックスに接続 をクリックして、Microsoft のログインと承認を完了します。

承認が完了したら、MCP アドレス https://你的服务地址/mcp をホームマシンに接続するだけです。

Microsoft の設定

Microsoft Entra / Azure App Registration でアプリを作成し、次の委任されたアクセス許可（Delegated permissions）を有効にします：

• openid

• profile

• offline_access

• User.Read

• Mail.Read

• Mail.ReadWrite

• Mail.Send

Redirect URI には次を使用します：

https://你的服务地址/auth/callback

アプリの種類は Web を選択します。

環境変数

MS_CLIENT_ID=你的 Application (client) ID
MS_CLIENT_SECRET=你的 Client Secret VALUE
MS_TENANT_ID=common
TOKEN_DIR=/data

Render では、サーバーはまず PUBLIC_URL を使用し、それ以外の場合は Render が自動提供する RENDER_EXTERNAL_URL を使用して OAuth コールバック URL を生成します。

Render へのデプロイ

リポジトリにはすでに render.yaml が含まれているため、Render Blueprint で直接デプロイできます。

Render の構成には以下が含まれます：

• Node.js Web Service

• /health ヘルスチェック

• 1 GB 永続ディスク

• /data トークン保存ディレクトリ

• Microsoft OAuth に必要な環境変数

トークンは Render の永続ディスクに保存され、GitHub にはコミットされません。

MCP ツール

ローカル実行

npm install
npm start

デフォルトアドレス：http://localhost:3000/。

ローカル OAuth コールバック：http://localhost:3000/auth/callback。

セキュリティ

OAuth パスワードはホームマシンに渡されません。Microsoft のログイン完了後、サービスは OAuth トークンのみを保存します。トークンファイルのアクセス許可は、現在のプロセスのユーザーのみが読み書きできるように設定されます。

クレジット

Lynn × Sage（ChatGPT）
一人の人間開発者 + 1人の AI パートナーが、一緒にこの小さなツールを作り上げました。 🫳