Mcp Email

mcp-email

IMAP と SMTP 用のセルフホスト可能な MCP サーバーです。1 つの設定で複数のアカウントを利用できます。Claude Code および MCP 準拠のあらゆるクライアント向けに構築されています。

Gumroad で購入 — $49 · ランディングページ · プロバイダー設定ドキュメント

---

このリポジトリについて

これは、OneShotForge の有料製品である mcp-email の公開ページです。ソースコードは Gumroad で販売している有料バンドルに含まれています。 このリポジトリには以下が含まれます。

• 現在ご覧の README（機能、対象範囲、FAQ）
• プロバイダーごとの設定ドキュメント全文（docs/CONFIG.md）
• 公開変更履歴（CHANGELOG.md）
• ライセンス条項（LICENSE）

購入をご検討中の方へ：mcp-email がご利用の環境に適しているかどうかを判断するには、こちらの情報で十分です。購入リンクはページ上部にあります。

すでに購入済みの方へ：TypeScript ソース全文、Docker の設定、ビルド設定、完全なインストールガイドは、購入後に受け取った zip ファイルに含まれています。

---

開発の背景

Anthropic の MCP 仕様を使うと、エージェントがツールとやり取りできます。最も多く求められているツールはメールです。しかし、私が試した既存の「MCP メール」サーバーは、Gmail しか使えなかったり、設定に半日かかるような OAuth を要求したり、2 つ目のアカウントを指定した途端に動かなくなったりしました。

こうした問題を見極めたあと、自分用に作ったのが mcp-email です。今では問題を十分にすっきり解決できるようになったため、無料で保守し続けるより、対価をいただいて保守することにしました。

主な特長：

• あらゆる IMAP/SMTP プロバイダーに対応 — Gmail、Hostinger、Fastmail、iCloud、Outlook 365、Proton（Bridge 経由）、Yahoo、Zoho、カスタムドメインなど、プロトコルに対応するあらゆるサービスを利用できます。
• 1 つの設定で複数アカウントに対応 — 環境変数で N 個のアカウントを指定し、各ツール呼び出しで account 引数を渡します。1 つのサーバーインスタンスからすべてのアカウントを利用できます。
• 本番環境向けの 15 種類のツール — 一覧表示、検索、読み取り、スレッド、添付ファイル、送信、下書き、移動、コピー、削除、フラグ、フォルダーの CRUD に対応しています。基本的な操作はひと通り網羅しています。
• セルフホスト可能で、認証情報は手元の環境から外に出ません — npm でローカル実行するか、Docker で実行できます。MCP エンドポイントでは Bearer トークン認証を使用します。テレメトリーも SaaS プロキシもありません。
• .env ファイル 1 つで設定完了 — OAuth の煩雑な手順も、サービスアカウントの JSON も、Google Cloud プロジェクトも不要です。プロバイダー側でアプリパスワードを生成して記入すれば完了です。

---

購入すると利用できるもの

Gumroad で購入後、以下を含む zip ファイルを 1 つダウンロードできます。

• サーバーのTypeScript ソース全文（Node 20+、@modelcontextprotocol/sdk、imapflow、nodemailer）
• すぐに実行できる Dockerfile と docker-compose.yml
• テンプレート全文と行内コメントを含む .env.example
• インストール手順、Claude Code との接続方法、Caddy を使った本番環境へのデプロイ、トラブルシューティングを記載した README 拡張版
• 無期限の商用ライセンス（完全な条項は LICENSE をご覧ください。ビジネスでの利用は無制限、再販売不可、適合しない場合は初日以内であれば返金可能です）
• 1.x メジャーバージョン内のパッチおよびマイナーアップデートは無料

購入後、最初のツール呼び出しまでにかかる時間の目安は、プロバイダーのアプリパスワードをすでに生成している場合で 5 分です。

---

プロバイダー一覧

普段はHostingerとGmailを使っています。ほかのプロバイダーについても、セットアップ手順を文書化し、動作確認済みです。

プロバイダー	認証	IMAP ホスト	SMTP ホスト	備考
Hostinger	メールボックスのパスワード	imap.hostinger.com:993	smtp.hostinger.com:465	[email protected] で使用しています。mail-tester.comで10/10の評価です。
Gmail / Workspace	アプリパスワード	imap.gmail.com:993	smtp.gmail.com:465	先に2FAを有効にしてください。Workspaceの管理者は、組織単位でIMAPを無効にできます。
Fastmail	アプリパスワード	imap.fastmail.com:993	smtp.fastmail.com:465	実装がシンプルで、問題もありません。
iCloud Mail	App用パスワード	imap.mail.me.com:993	smtp.mail.me.com:587	SMTPは587/STARTTLSを使用します。
Outlook 365	アプリパスワード	outlook.office365.com:993	smtp.office365.com:587	SMTP AUTHを無効にしているテナントもあります。個人アカウントは常に動作します。
Proton Mail	Proton Bridge経由	127.0.0.1:1143	127.0.0.1:1025	Bridgeをローカルで起動しておく必要があります。
Yahoo Mail	アプリパスワード	imap.mail.yahoo.com:993	smtp.mail.yahoo.com:465	アカウントのセキュリティ設定でアプリパスワードを設定します。
Zoho Mail	アプリパスワード（または通常のパスワード）	imap.zoho.eu:993 / .com	smtp.zoho.eu:465 / .com	EUとUSのテナントではホストが異なります。
Generic	アプリパスワードまたは通常のパスワード	環境による	環境による	RFCに準拠したプロバイダーであれば利用できます。

プロバイダーごとの詳しいセットアップ手順は、docs/CONFIG.mdをご覧ください。

---

15個のツール

すべてのツールでaccountパラメーターを指定します。これは.envで宣言したIDです。該当する場合、フォルダーはデフォルトでINBOXになります。

読み取り（6）

ツール	用途
email_list_folders	未読数とともに、すべてのIMAPフォルダーを一覧表示します
email_list_messages	ページネーションと未読フィルターを指定して、フォルダー内のメッセージを一覧表示します
email_search_messages	送信者、件名、本文、日付、または添付ファイルの有無で検索します
email_get_message	UIDを指定して、メッセージ本文全体（テキスト＋HTML＋添付ファイルのメタデータ）を取得します
email_get_attachment	添付ファイルの内容（UTF-8またはbase64）を取得します
email_get_thread	Message-ID / In-Reply-To / Referencesから会話スレッドを再構成します

書き込み（2）

ツール	用途
email_send_message	SMTPで送信し、IMAP経由で送信済みフォルダーにコピーを追加します
email_create_draft	下書きフォルダーに下書きを作成します

管理（7）

ツール	用途
email_move_message	メッセージを別のフォルダーに移動します
email_copy_message	メッセージを別のフォルダーにコピーします
email_delete_message	メッセージをゴミ箱（デフォルト）に移動するか、\Deletedを付けて完全削除します
email_mark_message	\Seen / \Flagged / \Answeredフラグを設定または解除します
email_create_folder	IMAPフォルダーを作成します
email_rename_folder	IMAPフォルダーの名前を変更します
email_delete_folder	IMAPフォルダーを削除します

---

Claude Codeとの接続方法

インストール後（zipに手順が記載されています）、プロジェクトの.mcp.jsonまたはグローバル設定の~/.claude.jsonに次の内容を追加します。

{
  "mcpServers": {
    "email": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_AUTH_TOKEN"
      }
    }
  }
}

Claude Codeを再起動し（/mcpでサーバーがconnectedになっていることを確認してください）、次のように試します。

「アカウントmainの未読メールを、最新のものから5件一覧表示して。」

または、複数アカウントを使った高度な操作では、次のようにします。

「過去7日間に[email protected]から届いた未返信のメッセージをアカウントsupportで検索して、要約し、アカウントmainで返信の下書きを作成して。」

---

料金

一回限りの49ドル。 永続的な商用ライセンスで、ビジネス利用は無制限、継続料金はありません。

セットアップに合わない場合は、当日中に返金します。購入から24時間以内に[email protected]へメールしてください。ご連絡をいただいたときに寝ている場合は、翌朝に返金手続きをします。

Gumroadで購入

---

制限事項と対象範囲（意図的なもの）

• 認証：アプリパスワードまたは通常のパスワードのみです。OAuth 2.0 には対応していません。これにより、サーバーはステートレスになり、特定のプロバイダーに依存しません。
• トランスポート：HTTP のみです（stdio は対象外です）。リモートエージェントと共有インフラストラクチャをサポートするモードは、HTTP 経由の MCP のみです。
• フォルダー名：既定では INBOX、Sent、Drafts、Trash を想定しています。INBOX.Sent のようなプレフィックス付きのサーバーには、フォールバックで対応します。独自の名前を使用する場合は、コードを少し変更する必要があります。
• 添付ファイルのダウンロード：バイナリ添付ファイルには 1 MB の上限があります（base64 として返されます）。テキスト形式の添付ファイル（text/*、JSON、XML、ICS）には上限がありません。
• HTML 本文：email_get_message では 25,000 文字を超える部分が切り詰められます。テキスト本文は常に全文が送信されます。

---

ロードマップ（1.0 以降、未確定）

• アカウントごとに環境変数で SENT_FOLDER / DRAFTS_FOLDER / TRASH_FOLDER を任意に指定
• Gmail および Microsoft 向け OAuth フロー（別のアドオンとして提供し、同梱はしません）
• メール受信時の Webhook（エージェント向けのプッシュ型通知）
• カレンダー／ICS ブリッジ（別製品として提供し、スムーズに統合できるようにします）
• Anthropic API による AI 自動タグ付け

次に欲しい機能をメールで投票してください。[email protected]

---

ライセンス

商用ライセンスです。詳細は LICENSE をご覧ください。

要約：購入後は個人・商用を問わず無制限に利用できます。ソースの転売や再配布はできません。

---

サポート

• バグ報告と機能リクエスト：明確な再現手順を添えて、[email protected] までメールでご連絡ください。
• ライセンスに関するご質問、ボリューム価格：同じ宛先までご連絡ください。
• 公開変更履歴：CHANGELOG.md。

OneShotForge が開発しました。