Email MCP App

🚀 mcp-email-server

このプロジェクトは、ai-zerolabによるオリジナルの mcp-email-server をベースにしたカスタム拡張版です。

MCPサーバーを介したIMAPとSMTPです。

• Githubリポジトリ: https://github.com/ai-zerolab/mcp-email-server/
• ドキュメント https://ai-zerolab.github.io/mcp-email-server/

📦 インストール

手動インストール

環境管理には uv の使用をおすすめします。

uvx mcp-email-server@latest ui を試して設定を行い、mcpクライアントには以下の設定を使用します。

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"]
    }
  }
}

このパッケージはPyPIで利用可能なので、pip install mcp-email-server を使用してインストールできます。

その後、mcp-email-server ui を使用してメールサーバーを設定します。

環境変数による設定

JenkinsのようなCI/CD環境では、環境変数を使用してメールサーバーを設定することもできます。zerolib-emailはUI設定（TOMLファイルを介して）と環境変数の両方をサポートしており、環境変数が優先されます。

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "work",
        "MCP_EMAIL_SERVER_FULL_NAME": "John Doe",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "john@example.com",
        "MCP_EMAIL_SERVER_USER_NAME": "john@example.com",
        "MCP_EMAIL_SERVER_PASSWORD": "your_password",
        "MCP_EMAIL_SERVER_IMAP_HOST": "imap.gmail.com",
        "MCP_EMAIL_SERVER_IMAP_PORT": "993",
        "MCP_EMAIL_SERVER_SMTP_HOST": "smtp.gmail.com",
        "MCP_EMAIL_SERVER_SMTP_PORT": "465"
      }
    }
  }
}

利用可能な環境変数

添付ファイルのダウンロードを有効にする

セキュリティ上の理由から、メール添付ファイルのダウンロードはデフォルトで無効になっています。この機能を有効にするには、以下のいずれかの方法を使用できます。

オプション1: 環境変数

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"],
      "env": {
        "MCP_EMAIL_SERVER_ENABLE_ATTACHMENT_DOWNLOAD": "true"
      }
    }
  }
}

オプション2: TOML設定

TOML設定ファイル (~/.config/zerolib/mcp_email_server/config.toml) に enable_attachment_download = true を追加します。

enable_attachment_download = true

[[emails]]
# ... あなたのメール設定

有効にしたら、download_attachment ツールを使用してメール添付ファイルを指定されたパスに保存できます。

送信したメールをIMAPの送信済みフォルダに保存する

デフォルトでは、送信したメールは自動的にIMAPの送信済みフォルダに保存されます。これにより、MCPサーバーを介して送信されたメールがメールクライアント（Thunderbird、ウェブメールなど）に表示されます。

サーバーは一般的な送信済みフォルダ名を自動検出します: Sent, INBOX.Sent, Sent Items, Sent Mail, [Gmail]/Sent Mail。

カスタムの送信済みフォルダ名を指定するには（非標準のフォルダ名を持つプロバイダーに役立ちます）:

オプション1: 環境変数

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"],
      "env": {
        "MCP_EMAIL_SERVER_SENT_FOLDER_NAME": "INBOX.Sent"
      }
    }
  }
}

オプション2: TOML設定

[[emails]]
account_name = "work"
save_to_sent = true
sent_folder_name = "INBOX.Sent"
# ... あなたのメール設定の残り部分

送信済みフォルダへの保存を無効にするには、TOML設定で MCP_EMAIL_SERVER_SAVE_TO_SENT=false または save_to_sent = false を設定します。

別のIMAP/SMTP資格情報を使用する場合は、以下も使用できます。

• MCP_EMAIL_SERVER_IMAP_USER_NAME / MCP_EMAIL_SERVER_IMAP_PASSWORD
• MCP_EMAIL_SERVER_SMTP_USER_NAME / MCP_EMAIL_SERVER_SMTP_PASSWORD

その後、Claude Desktop で試すことができます。他のmcpクライアントと統合する場合は、$which mcp-email-server でパスを取得し、クライアントで以下のように設定します。

{
  "mcpServers": {
    "zerolib-email": {
      "command": "{{ ENTRYPOINT }}",
      "args": ["stdio"]
    }
  }
}

docker が利用可能な場合は、Dockerイメージを試すことができますが、MCP を介した tools を使用してクライアントで設定する必要があります。デフォルトの設定パスは ~/.config/zerolib/mcp_email_server/config.toml です。

{
  "mcpServers": {
    "zerolib-email": {
      "command": "docker",
      "args": ["run", "-it", "ghcr.io/ai-zerolab/mcp-email-server:latest"]
    }
  }
}

Smitheryを介したインストール

Smithery を介してClaude Desktop用のメールサーバーを自動的にインストールするには、以下を実行します。

npx -y @smithery/cli install @ai-zerolab/mcp-email-server --client claude

💻 使用例

メールの返信

適切なスレッディングでメールに返信するには（メールクライアントで同じ会話に表示されるように）:

1. まず、元のメールを取得して message_id を取得します。

emails = await get_emails_content(account_name="work", email_ids=["123"])
original = emails.emails[0]

2. in_reply_to と references を使用して返信を送信します。

await send_email(
    account_name="work",
    recipients=[original.sender],
    subject=f"Re: {original.subject}",
    body="Thank you for your email...",
    in_reply_to=original.message_id,
    references=original.message_id,
)

in_reply_to パラメータは In-Reply-To ヘッダーを設定し、references は References ヘッダーを設定します。両方ともメールクライアントが会話を適切にスレッド化するために使用されます。

🔧 開発

このプロジェクトは uv を使用して管理されています。

make install を試して仮想環境をインストールし、pre-commitフックをインストールします。

ローカル開発には uv run mcp-email-server を使用します。

新しいバージョンのリリース

• PyPI でAPIトークンを作成します。
• このページ を訪問して、APIトークンを PYPI_TOKEN という名前でプロジェクトのシークレットに追加します。
• Githubで 新しいリリース を作成します。
• *.*.* の形式で新しいタグを作成します。

詳細については、こちら を参照してください。