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(文字列配列, オプション): CCbcc(文字列配列, オプション): BCCattachments(オブジェクト配列, オプション): 添付ファイル
list_inbox
受信トレイのメール一覧を取得します。
search_emails
キーワードまたは条件でメールを検索します。
delete_email
メールを削除します。
manage_folders
フォルダ(ラベル)の作成、一覧表示、削除を行います。
account_settings
アカウント設定の表示と更新を行います。
自動検出の仕組み
自動検出は次の順序でサーバー設定を解決します:
- DNS SRVレコードの確認 (
_imap._tcp.example.com) - 既知のプロバイダーパターンとの照合(Gmail、Outlook、Yahoo!など)
- 一般的なサーバーホスト名の推測 (
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