Email MCP Server

Email MCP サーバー

AI アシスタントが SMTP 経由でメールを送信できるようにする MCP（Model Context Protocol）サーバーです。

機能

• send_simple_email — 簡単なメール（テキストまたは HTML）を送信します。任意の smtp_config を受け付けます
• send_custom_email — 完全な制御: CC/BCC、添付ファイル。任意の smtp_config を受け付けます
• test_smtp_connection — 送信前に SMTP 設定を検証します。任意の smtp_config を受け付けます

クイックスタート

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

cd email-mcp-server
uv sync --extra dev

SMTP を設定し（次のセクションを参照）、次を実行します:

# stdio transport (for MCP clients)
uv run python -m email_mcp_server.server

# Streamable HTTP transport (port 8000)
uv run python -m email_mcp_server.server --http

テストを実行します:

uv run pytest

SMTP 設定

SMTP 認証情報は 2 つの方法で設定できます — どちらか一方、または両方を使用してください。

オプション A: 環境変数

サンプルをコピーして、認証情報を入力します:

cp env.example .env

# Required
SMTP_HOST=smtp.gmail.com
[email protected]
SMTP_PASS=your-app-password
[email protected]

# Optional (defaults shown)
# SMTP_PORT=587
# SMTP_SECURE=false

あるいは、クライアントの env ブロックで渡すこともできます（以下の「クライアント設定」を参照）。

オプション B: 呼び出しごとのペイロード

任意のツール呼び出しで smtp_config を直接渡します — その呼び出しでは環境変数は無視されます:

{
  "smtp_config": {
    "host": "smtp.gmail.com",
    "port": 587,
    "secure": false,
    "username": "[email protected]",
    "password": "your-app-password",
    "from_email": "[email protected]"
  }
}

フィールド	型	説明
host	string	SMTP サーバーのホスト名
port	integer	SMTP サーバーのポート（通常は 587）
secure	boolean	SSL/TLS を使用（STARTTLS の場合は false）
username	string	認証ユーザー名
password	string	認証パスワード
from_email	string	送信者のメールアドレス

クライアント設定

Claude Code

# stdio
claude mcp add email-server -- uv --directory /absolute/path/to/email-mcp-server run python -m email_mcp_server.server

# streamable HTTP (start the server first with --http)
claude mcp add --transport http email-server http://localhost:8000/mcp

JSON ベースのクライアント（Claude Desktop、Cursor、VS Code、Windsurf、Zed）

以下の汎用例を使用し、お使いのクライアントに合わせてトップレベルのキーと設定ファイルのパスを調整してください:

{
  "<top-level-key>": {
    "email-server": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/email-mcp-server", "run", "python", "-m", "email_mcp_server.server"],
      "env": {
        "SMTP_HOST": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_SECURE": "false",
        "SMTP_USER": "[email protected]",
        "SMTP_FROM": "[email protected]",
        "SMTP_PASS": "your-app-password"
      }
    }
  }
}

クライアント	設定ファイルのパス	トップレベルのキー	備考
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json	mcpServers	Windows: %APPDATA%\Claude\...
Cursor	~/.cursor/mcp.json	mcpServers	または .cursor/mcp.json（プロジェクト）
VS Code	.vscode/mcp.json	servers	サーバーエントリ内に "type": "stdio" を追加
Windsurf	~/.codeium/windsurf/mcp_config.json	mcpServers
Zed	~/.config/zed/settings.json	context_servers

Streamable HTTP（任意のクライアント）

uv run python -m email_mcp_server.server --http でサーバーを起動し、次を実行します:

クライアント	設定
Claude Code	claude mcp add --transport http email-server http://localhost:8000/mcp
Claude Desktop	{ "type": "http", "url": "http://localhost:8000/mcp" }
Cursor	{ "url": "http://localhost:8000/mcp" }
VS Code	{ "type": "http", "url": "http://localhost:8000/mcp" }
Windsurf	{ "serverUrl": "http://localhost:8000/mcp" }
Zed	{ "url": "http://localhost:8000/mcp" }

プロバイダー設定

プロバイダー	ホスト	備考
Gmail	smtp.gmail.com	2 段階認証を有効にした上でアプリパスワードが必要
Outlook	smtp-mail.outlook.com	通常のパスワードまたはアプリパスワード
Yahoo	smtp.mail.yahoo.com	2 段階認証を有効にした上でアプリパスワードが必要
iCloud	smtp.mail.me.com	2 段階認証を有効にした上でアプリパスワードが必要

すべてのプロバイダーはポート 587 と SMTP_SECURE=false（STARTTLS）を使用します。

ライセンス

MIT License