SMTP Email MCP Server

Email SMTP/IMAP MCP

すべての受信トレイに対応する1つのローカルMCPサーバーです。複数のアカウント間でメールを検索、閲覧、送信、返信、転送、整理できます。

このサーバーを選ぶ理由

• アカウント数の上限なし — 仕事用、個人用、サポート用、クライアント用の受信トレイを追加し、account_nameで切り替えられます。
• SMTPとIMAPを一体化 — 1つの小さなMCPサーバーでメールを送受信できます。
• 日常的なワークフローを網羅 — メールの検索、閲覧、返信、転送、ファイルの添付、フラグ付け、アーカイブ、移動、フォルダー一覧の取得ができます。
• プロバイダーを選ばない — Gmail、iCloud Mail、Fastmail、Outlook、セルフホストのメール、その他の標準的なSMTP/IMAPプロバイダーで動作します。
• ローカルのstdioトランスポート — ホスト型リレーも独立したコントロールパネルも必要ありません。

クイックスタート

1. .envを作成する

.env.exampleをプライベートな場所にコピーし、必要な数の名前付きアカウントを追加します。

EMAIL_ACCOUNTS_JSON='{
  "work": {
    "smtp": {
      "host": "smtp.gmail.com",
      "port": 587,
      "secure": false,
      "user": "[email protected]",
      "password": "app-password"
    },
    "imap": {
      "host": "imap.gmail.com",
      "port": 993,
      "secure": true,
      "user": "[email protected]",
      "password": "app-password"
    },
    "default_from_name": "Your Name",
    "sender_emails": ["[email protected]", "[email protected]"]
  },
  "personal": {
    "smtp": {
      "host": "smtp.mail.me.com",
      "port": 587,
      "secure": false,
      "user": "[email protected]",
      "password": "app-password"
    },
    "imap": {
      "host": "imap.mail.me.com",
      "port": 993,
      "secure": true,
      "user": "[email protected]",
      "password": "app-password"
    }
  }
}'

DEFAULT_EMAIL_ACCOUNT="work"

サーバーは作業ディレクトリにある.envを自動的に読み込みます。EMAIL_ENV_FILEを指定すると、MCPクライアントは任意の場所に保存された.envを使用できます。

2. MCPサーバーを追加する

Claude Desktopの場合、次のファイルを編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["-y", "email-smtp-imap-mcp"],
      "env": {
        "EMAIL_ENV_FILE": "/absolute/path/to/your/.env"
      }
    }
  }
}

絶対パスを指定してMCPクライアントを再起動し、「設定済みのメールアカウントを一覧表示して」と尋ねてみましょう。

{
  "env": {
    "EMAIL_ACCOUNTS_JSON": "{\"work\":{\"smtp\":{\"host\":\"smtp.gmail.com\",\"port\":587,\"user\":\"[email protected]\",\"password\":\"app-password\"},\"imap\":{\"host\":\"imap.gmail.com\",\"port\":993,\"user\":\"[email protected]\",\"password\":\"app-password\"}}}",
    "DEFAULT_EMAIL_ACCOUNT": "work"
  }
}

すべてのメールツールでは、account_name を任意で指定できます。指定しない場合、サーバーは DEFAULT_EMAIL_ACCOUNT または最初に設定されたアカウントを使用します。アプリケーションレベルのアカウント数の上限はありません。

設定を確認する

MCP クライアントを再起動した後、次の順に試してください。

1. 「設定済みのメールアカウントを一覧表示してください。」
2. 「work アカウントのフォルダーを一覧表示してください。」
3. 「personal アカウントで、最新の未読メールを5件見つけてください。」
4. 「work アカウントからプレーンテキストのメールを送信してください。」

プロバイダー設定

465/993 などの暗黙的な TLS ポートには secure: true を使用してください。ポート 587 では通常 secure: false を使用し、STARTTLS で接続をアップグレードします。

開発

git clone https://github.com/samihalawa/email-smtp-imap-mcp.git
cd email-smtp-imap-mcp
npm ci
npm test

コンパイル済みの stdio サーバーは npm start で実行します。docker build -t email-smtp-imap-mcp . で本番用コンテナーをビルドします。

貢献

Issue や目的を絞ったプルリクエストを歓迎します。開発ワークフローについては CONTRIBUTING.md を、脆弱性の報告については SECURITY.md を参照してください。

ライセンス

MIT © Sami Halawa