mail-mcp-oauth

セルフホスト型で、OAuth 2.1対応のIMAP/SMTP MCPサーバー（Claude.ai向け）— maxx3250/claude-mail-mcp のフォークです。OAuth 2.1 + 動的クライアント登録（DCR） + PKCE レイヤーを内蔵し、Render上で単一のステートレスプロセスとして実行できるよう調整されています（VPS、nginx、systemd、永続ディスクは不要）。

マルチアカウント対応: 1つのデプロイで複数のメールボックス（Gmail、カスタムドメインなど）を利用でき、それぞれIMAP/SMTPでアクセスできます。各MCPツールは、操作対象のメールボックスを選ぶオプションのaccountパラメータを受け取ります。

アップストリームからの変更点

• OAuth 2.1を内蔵（src/oauth.ts）: /register（DCR）、/authorize（PKCE + シングルユーザーログインフォーム）、/token。独立したOAuthシムプロセスは不要です。アップストリームでは言及されていますが公開されていないため、このフォークでは同じExpressアプリ内に直接実装しています。

• 設計上ステートレス — アクセストークン/リフレッシュトークンは署名済みのJWT（DB不要）。登録済みOAuthクライアントと処理中の認証コードはメモリ上に保持されます（再起動するとClaude.aiが自動的に再登録するだけで、その処理はMCPクライアントがすでに行います）。

• 環境変数からアカウント設定: Renderのファイルシステムはephemeralなため、ディスク上のファイルではなくACCOUNTS_JSONを使用します。ファイルベースのACCOUNTS_FILEは、ローカル/VPS利用時には引き続き使用可能です。

• CalDAV/カレンダーツールを削除 — このデプロイには不要で、依存関係も削減できます（tsdav、ical.js）。

Related MCP server: IMAP MCP Server

アーキテクチャ

Claude.ai (web)
    │  HTTPS + OAuth 2.1 (DCR, PKCE, JWT)
    ▼
Render (TLS terminated automatically, custom domain mcp-mail.<domain>)
    ▼
this process (single Node service)
    ├── /.well-known/oauth-authorization-server, /register, /authorize, /token   (src/oauth.ts)
    ├── /mcp  (Bearer-gated MCP Streamable HTTP transport)
    │     ├── ImapClient   ──▶ imapflow   ──▶ IMAP server (993/143) per account
    │     └── SmtpClient   ──▶ nodemailer ──▶ SMTP server (465/587) per account
    └── /health

ローカルセットアップ

npm install
cp .env.example .env
# fill in PUBLIC_URL, ACCOUNTS_JSON (see docs/ACCOUNTS.md), OAUTH_USER,
# OAUTH_PASS, and JWT_SECRET (openssl rand -hex 32)
npm run dev

Renderへのデプロイ

詳細な手順（GitHub push、Render Webサービス、カスタムドメイン、Netcup DNS、Claude.aiの接続）は docs/DEPLOY_RENDER.md を参照してください。

アカウント

accounts.jsonのスキーマとプロバイダー別設定（Gmailのアプリパスワード、Netcup WebhostingのIMAP/SMTP、そしてHotmail/Outlook.com が別途OAuth2フローを必要とする理由）については docs/ACCOUNTS.md を参照してください。

Claudeに公開されるツール

ライセンス

MIT — LICENSE を参照してください。原著作者: Markus Stöger（maxx3250/claude-mail-mcp）。