Communityライティング&編集github.com

n24q02m/better-email-mcp

IMAP/SMTPメールサーバー for AIエージェント -- 6つの複合ツール、マルチアカウント、自動検出対応

better-email-mcp とは?

better-email-mcpは、AIエージェントがメールを送受信・管理できるようにするIMAP/SMTPベースのMCPサーバーです。6つの複合ツール(メール送信、受信ボックス一覧、メール検索、メール削除、フォルダ管理、アカウント設定)を提供し、複数のメールアカウントを同時に扱えるマルチアカウント機能と、IMAP/SMTP設定を自動検出するauto-discovery機能を備えています。これにより、開発者はGmailやOutlookなど主要なメールプロバイダーのサーバー設定を手動で指定することなく、AIエージェントにメール操作を任せられます。Claude CodeやCursor、CodexなどのAIエージェントプラットフォーム上で動作し、JSON-RPCを介してツール呼び出しを行います。自動検出機能はDNSのSRVレコードや一般的なサーバーパターンを利用して設定を取得するため、ユーザーは最小限の構成で使い始めることができます。

対応~Claude Code~Codex CLI~Cursor
npx skills add n24q02m/better-email-mcp

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

better-email-mcp は何をしますか?

AIエージェント向けIMAP/SMTPメールサーバー -- 6つの複合ツール、マルチアカウント、自動検出対応

このMCPサーバーは、AIエージェントがメールを操作できるようにするための統合インターフェースを提供します。IMAPとSMTPプロトコルをラップし、メールの送受信、検索、管理をシンプルなツール呼び出しで実現します。

機能

  • 6つの複合ツール: メール送信、受信ボックス一覧、メール検索、メール削除、フォルダ管理、アカウント設定
  • マルチアカウント対応: 複数のメールアカウントを同時に接続・管理可能
  • 自動検出 (Auto-Discovery): DNS SRVレコードや一般的なパターンを用いてIMAP/SMTPサーバー設定を自動的に検出
  • IMAP/SMTP標準準拠: 主要なメールプロバイダー(Gmail、Outlook、Yahoo Mailなど)と互換性あり
  • セキュアな認証: OAuth2またはアプリパスワードに対応

対応プラットフォーム

  • Claude Code
  • Cursor
  • Codex
  • その他MCPプロトコル対応のAIエージェント

インストール

npx @anthropic/mcp-installer install n24q02m/better-email-mcp

または、手動で設定ファイルに追加:

{
  "mcpServers": {
    "better-email": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-better-email"],
      "env": {
        "EMAIL_ACCOUNTS": "[{\"email\":\"[email protected]\",\"password\":\"app_password\"}]"
      }
    }
  }
}

設定

環境変数:

変数名説明必須
EMAIL_ACCOUNTSアカウント設定のJSON配列はい
EMAIL_DISCOVERY自動検出を有効にするかどうか (true/false)いいえ (デフォルト: true)

アカウント設定例:

[
  {
    "email": "[email protected]",
    "password": "app_password_or_oauth_token",
    "provider": "gmail"
  },
  {
    "email": "[email protected]",
    "password": "app_password",
    "imap": "outlook.office365.com",
    "smtp": "smtp.office365.com"
  }
]

ツール一覧

send_email

メールを送信します。

パラメータ:

  • to (文字列配列): 宛先
  • subject (文字列): 件名
  • body (文字列): 本文 (HTML対応)
  • cc (文字列配列, オプション): CC
  • bcc (文字列配列, オプション): BCC
  • attachments (オブジェクト配列, オプション): 添付ファイル

list_inbox

受信トレイのメール一覧を取得します。

search_emails

キーワードまたは条件でメールを検索します。

delete_email

メールを削除します。

manage_folders

フォルダ(ラベル)の作成、一覧表示、削除を行います。

account_settings

アカウント設定の表示と更新を行います。

自動検出の仕組み

自動検出は次の順序でサーバー設定を解決します:

  1. DNS SRVレコードの確認 (_imap._tcp.example.com)
  2. 既知のプロバイダーパターンとの照合(Gmail、Outlook、Yahoo!など)
  3. 一般的なサーバーホスト名の推測 (imap.example.com, smtp.example.com)

開発

# リポジトリのクローン
git clone https://github.com/n24q02m/better-email-mcp.git

# 依存関係のインストール
cd better-email-mcp
npm install

# 開発サーバーの起動
npm run dev

ライセンス

MIT

関連スキル