mailmcp

mailmcp

ChatGPT と Claude で、すべてのメールボックスを利用できます。パスワードはご自身で管理できます。

mailmcp はセルフホスト可能な MCP サーバーです。IMAP と SMTP を通じて、ChatGPT、Claude、その他の MCP クライアントからメールにアクセスできます。複数のメールボックスを同時に利用でき、プロバイダーを問わず、添付ファイルの送受信にも対応します。このリポジトリは、商用ライセンスのビルド済み配布版（dist/ 内の最小化済みバンドルで、ビルド手順は不要）です。キーなしで無料プランとして動作します。ソースコードは提供されていません。

*「今週、経理から何が届いた？」*と尋ねれば、Gmail、iCloud、会社のメールサーバーを横断してひとつの回答が得られます。請求書はダウンロードリンクで表示され、返信もすでに下書きされています。

どんなときに使うか

複数のメールボックスを使っている場合、公式コネクターがないプロバイダーを利用している場合、または添付ファイルが必要な場合は mailmcp をお使いください。2026年9月時点で、ChatGPT と Claude の公式 Gmail および Outlook コネクターはそれぞれ1つのメールボックスにしか対応しておらず、添付ファイルを送信できません。

	公式コネクター	mailmcp
メールボックス	コネクターごとに1つ	複数を同時に利用、トークン1つ
プロバイダー	Gmail、Outlook	Gmail、Outlook.com、Microsoft 365、iCloud、Fastmail、Yahoo、Zoho、Seznam.cz、およびパスワードでサインインできる任意の IMAP/SMTP サーバー（独自ドメインを含む）
添付ファイル	一部を受信可能、送信不可	1時間有効のダウンロードリンク。メールボックスから送信、アシスタントがアップロードしたファイルから送信、または転送が可能
認証	AI ベンダーが保持する OAuth 権限	アプリパスワードをブラウザー内でトークンに暗号化。サーバーが保持するのは1つのマスターキーのみで、データベースは不要
ホスティング	ベンダー側	お客様側：Vercel、Docker、任意の Node 22 ホスト、またはサーバーなしの Claude Desktop
費用	アシスタントのプランに含まれる	送信メールに署名を付けて無料で利用、または買い切り（€19 / €149）

クイックスタート

必要なもの。 Node 22（または Vercel、Docker）、HTTPS アドレス（ChatGPT と Claude は HTTPS 経由でのみ接続可能）、各メールボックスのアプリパスワード。Gmail の場合は、まず 2 段階認証プロセスを有効にしてください。有効にしないと、Google でアプリパスワードのページが表示されません（組織のポリシーや高度な保護機能によっても非表示になることがあります）。Outlook.com と Microsoft 365 ではパスワードは不要です。ユーザーはセットアップページで Microsoft にサインインします（下記「Outlook と Microsoft 365」を参照）。

1. 招待コードを設定します。 ユーザートークンを発行するサーバーでは、誰がトークンを作成できるかを指定する必要があります。指定しないと、アドレスを知っている人なら誰でも割り当て量を消費できてしまいます。MAILMCP_INVITE_CODE（8文字以上）を決めて、トークンを作成できる人に伝えてください。設定しない場合、サーバーはトークンを発行せず、セットアップページに通知が表示されます。コードを忘れた場合は、Vercel または Docker の環境設定で確認するか、新しいコードを設定して再デプロイしてください。発行済みのトークンは引き続き使用できます。意図的に公開するサーバーでは、代わりに MAILMCP_OPEN_SIGNUP=1 を設定します。

2. デプロイします。 上の Vercel ボタンをクリックすると、MAILMCP_KEY（base64url 形式のランダムな32バイト。node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))"）、MAILMCP_LICENSE（ライセンスキー、または無料プランの場合は空欄）、およびステップ1で設定した招待コードの入力を求められます。または、自分で実行します。

   docker build -t mailmcp . && docker run -d -p 8080:8080 \
     -e MAILMCP_KEY=… -e MAILMCP_LICENSE=… -e MAILMCP_INVITE_CODE=… \
     -e MAILMCP_PUBLIC_URL=https://mail.example.com mailmcp
   # without Docker: node dist/node.js with the same variables
   

3. https://<your-server>/start を開き、画面の指示に従います。 セットアップページでプロバイダーを選び、メールアドレスとアプリパスワードを貼り付け、アシスタントに許可する操作を選択します（読み取りはデフォルトで有効です。次のステップとして下書きの作成がおすすめです。送信を許可する場合は、許可リストに登録した宛先に限定してください）。ページはブラウザー内でパスワードを暗号化し、トークンを1つ発行します。

4. 接続します。 ChatGPT → Settings → Apps → Create → URL https://<your-server>/mcp、claude.ai → Settings → Connectors → Add custom connector の順に進みます。トークンでサインインし、次のように尋ねてみてください。「メールアカウントを一覧表示してください。」

デプロイせずに試す。 共有サーバー mailmcp.ai/setup では同じコードが動作します。そこでトークンを作成して接続してください。共有サーバーの運営者は、リクエストを処理する間、技術的には設定を閲覧できます。そのため、企業では自社のサーバーを運用しています。

Claude Desktop、サーバー不要。 最新リリースから mailmcp.mcpb をダウンロードし、Claude Desktop で開いて、/setup → "Values for your own deployment" の設定を貼り付けます。

リバースプロキシの背後で運用する場合は、MAILMCP_PUBLIC_URL または MAILMCP_TRUST_PROXY=1 を設定してください。プライベートアドレス上の社内メールサーバーを利用するには、MAILMCP_ALLOW_PRIVATE_MAIL_HOSTS=1 が必要です。MAILMCP_KEY を変更すると、すべてのトークンが無効になります。全変数については .env.example を参照してください。

変数	機能
MAILMCP_KEY	唯一のマスターキーです。ユーザートークンを暗号化し、OAuth アーティファクトに署名します。変更すると、すべてのトークンが無効になります。
MAILMCP_LICENSE	ライセンスキーです。空の場合は無料プランで実行されます。
MAILMCP_INVITE_CODE	トークン発行サーバーで必須です。ユーザーが /setup で入力するコードで、8 文字以上である必要があります。
MAILMCP_OPEN_SIGNUP	招待コードの代わりに、意図的に公開しているサーバーで 1 を設定します。
MAILMCP_MS_CLIENT_ID	Microsoft サインイン用の独自の Entra アプリ登録 ID です。サーバーで Microsoft サインインを利用する場合は必須です（ベンダーのアプリは mailmcp.ai でのみ使用されます）。
MAILMCP_MS_REDIRECT	このオリジンがそのアプリでリダイレクト URI（https://<host>/api/ms/callback）として登録されている場合は 1 を設定します。設定ページでは、デバイスコードの代わりにポップアップからサインインするようになります。
MAILMCP_MS_DISABLED	1 を設定すると Microsoft サインインが非表示になり、すべての /api/ms/* ルートで 404 が返されます。
MAILMCP_DISABLE_GRAPH	1 を設定すると、すでに発行済みのトークンを含め、実行時に Outlook メールボックスへの接続が拒否されます。
MAILMCP_ATTACHMENT_DIRS	stdio のみ：添付ファイルを保存および読み取ることができるフォルダーです（macOS/Linux では :、Windows では ; で区切ります）。policy.attachment_dirs に加えて指定します。Claude Desktop では拡張機能の設定で指定します。
MAILMCP_NO_STATS	1 を設定すると使用統計が無効になります。日次の更新確認は引き続き行われます（コンテンツなしの GET /api/version）。
MAILMCP_STATS	サーバー版：0／false／off／no を設定すると、MAILMCP_NO_STATS=1 と同様に統計が無効になります。Claude Desktop やその他のデスクトップ（stdio）版：1／true／on／yes を設定すると統計が有効になります（拡張機能の設定「匿名の使用統計」でこの値が書き込まれます）。空または未設定の場合は無効のままです。
MAILMCP_NO_UPDATE_CHECK	1 を設定すると、更新確認も統計送信も行われず、mailmcp.ai へのリクエストが一切送信されません。
DO_NOT_TRACK	1／true を設定すると、MAILMCP_NO_STATS=1 と同様に統計が無効になります。
MAILMCP_PUBLIC_URL	独自のリバースプロキシの背後でサーバーを運用する場合の公開アドレスです。
MAILMCP_ALLOW_PRIVATE_MAIL_HOSTS	1 を設定すると、ユーザートークンでプライベートアドレスのメールサーバーを指定できるようになります。

Outlook と Microsoft 365

これらのメールボックスにはパスワードがありません。Microsoft はほとんどのアカウントでパスワードによるサインインを拒否します。ユーザーは /setup でプロバイダー Outlook / Microsoft 365 を選び、Sign in with Microsoft をクリックします。これには独自の Entra アプリ登録（MAILMCP_MS_CLIENT_ID、手順は以下）が必要です。これがない場合、セットアップページに Microsoft のサインインは表示されません。サーバーのオリジンが登録済みのリダイレクト URI（MAILMCP_MS_REDIRECT=1）の場合、ボタンをクリックするとアカウント選択画面が表示されるポップアップが開きます。それ以外の場合は、ユーザーに個人用アカウント（Outlook.com、Hotmail）と職場または学校のアカウント（Microsoft 365）のどちらでサインインするかを尋ね、それぞれ microsoft.com/link または login.microsoft.com/device で入力する短いコードを表示します。どちらの場合も、サインインには招待コードが必要です（デバイスコードの中継では、MAILMCP_OPEN_SIGNUP=1 でも招待コードが必要です）。また、ユーザーには同意画面にアプリ名が表示されます。トークンがベンダーに渡ることはありません。サインインはサーバー上で行われます。

ユーザーには次のように案内してください。1 トークンにつき Outlook メールボックスは最大 3 個です。同意する Microsoft の権限は、ユーザーが選択した機能に応じて設定されます（読み取り専用の場合は Mail.Read、それ以外の場合は Mail.ReadWrite と Mail.Send）。そのため、後から権限を広げるには新たなサインインが必要です。サインインの有効期間は約 90 日です（期限は /setup と list_accounts の reauth_by に表示され、当社の OAuth を介して更新するクライアントでは自動的に更新されます）。メールボックスのパスワードを変更しても有効期間は終了しませんが、Microsoft でアプリへのアクセスを取り消すと、そのアカウントを使用したすべてのトークンで終了します。同意を管理者に限定しているテナントでは、https://login.microsoftonline.com/organizations/adminconsent?client_id=<your client id> で一度だけ承認が必要です。メールは Microsoft Graph を経由するため、メッセージ ID は数値ではなく文字列で、ラベルは Outlook のカテゴリになります。詳細なガイド：mailmcp.ai/docs。

独自の Microsoft アプリ登録

サーバーで Microsoft サインインを使うには、独自のアプリ登録が必要です（ベンダーの登録は mailmcp.ai でのみ使用されます）。アプリを登録してポップアップフローを使ってください。このフローは個人用アカウントと職場アカウントの両方で動作します。新しい Microsoft 365 テナントでは、コードを使ったサインインがブロックされます（セキュリティの既定値、AADSTS530035）。

1. Microsoft Entra → App registrations → New registration を開き、サポートされているアカウントの種類として Accounts in any organizational directory and personal Microsoft accounts を選択します。
2. Authentication → Mobile and desktop applications プラットフォームを追加し（Web ではありません）、リダイレクト URI に https://<your host>/api/ms/callback を設定します。mailmcp はシークレットを持たないパブリッククライアントです。Web プラットフォームを選ぶと Microsoft はシークレットを要求し、サインインは AADSTS7000218 で失敗します。
3. Authentication → Allow public client flows: Yes を設定します。
4. API permissions → Microsoft Graph の委任された権限 Mail.Read、Mail.ReadWrite、Mail.Send、User.Read、offline_access を設定します。
5. MAILMCP_MS_CLIENT_ID=<Application (client) ID> と MAILMCP_MS_REDIRECT=1 を設定し、再デプロイします。

ユーザーの同意を検証済みの発行元に限定しているテナントでは、登録に対する発行元の検証（Microsoft AI Cloud Partner Program）、またはテナント全体に対する管理者の同意も必要です。

アシスタントにできること

すべてのツールは、メールボックスごとにトークンの権限で制限されます。

権限	ツール
read（デフォルト）	list_accounts、list_folders、search_messages（Gmail では Gmail 構文）、get_message、get_thread、get_attachment（1 時間有効なダウンロードリンク）、ChatGPT の search／fetch、triage、awaiting_replies、digest、list_followups、list_templates、unsubscribe（ドライラン。ワンクリックリクエストの送信には、デフォルトで無効になっている別個の unsubscribe 権限が必要です）
draft	create_draft、reply_draft、save_template、set_signature、upload_attachment、request_upload（アシスタント自身が入力する、1 時間有効なアップロードリンク）
send	send_message、reply_send、send_draft、forward_message。送信先は許可リストに登録されたアドレスのみです。必要に応じて、アプリのダイアログで確認した後にのみ送信できます
modify	modify_message（フラグ、フォルダー）、bulk_preview／bulk_apply（一括アーカイブ、既読にする、ラベル付け、移動。最初にプレビューを行い、その後プレビューに表示されたメッセージだけを対象にします）、set_followup、snooze、wake_snoozed
delete	trash_message と一括ゴミ箱移動。完全に削除されることはありません

各メールボックスには、確認メールに対する保護レベル（Off、Basic、Standard、Strict、Custom）もあります。新しいメールボックスは Standard で開始します。非表示にしたメールはすべての回答から除外され、Standard 以上では、ほかのメールに含まれるコードとサインインリンクも削除されます。一般的な確認メールには対応しますが、考えられるすべての確認メールに対応するわけではありません。アプリが MCP Apps に対応している場合、triage、digest、下書きツール、bulk_preview にはクリック可能なパネルも表示されます。セットアップページでトークンごとにパネルをオフにするか、stdio では MAILMCP_UI=off を設定してください。

すべてのツールがクライアントに表示されます。トークンで許可されていないツールを呼び出すと、不足している権限の名前を示すエラーが返されます。

セキュリティとデータフロー

• 認証情報。 セットアップページでは、ブラウザー上でメールボックスのパスワードを暗号化し、分割鍵トークンに格納します。サーバーはマスターキーを 1 つ保持し、リクエストを処理している間だけ設定を復号します。最後のリクエストから最大 15 分間メモリに保持し、データベースもメールのコピーも保持しません。
• サーバーから外部に送信されるもの。 メールプロバイダーへの IMAP／SMTP 通信と、アシスタントへのツール結果です（AI ベンダーに送信されるのはすべてのツール呼び出しの結果であり、パスワードは送信されません）。ライセンスの検証はオフラインで行われます。ベンダーへの唯一のリクエストは、以下に記載する利用統計を含む毎日のアップデート確認です。また、「購入」ボタンはベンダーにリンクしています。
• プロンプトインジェクション。 メッセージ本文は信頼できないデータとして扱われ、非表示テキストは除去され、ヘッダーフィールドはサニタイズされます。これにより、メールに埋め込まれた指示のリスクは軽減されますが、モデルを完全に免疫化できるわけではありません。
• プロトコル。 PKCE による OAuth 2.1、動的クライアント登録とクライアントメタデータドキュメント、リプレイ攻撃対策を備えた暗号化トークン、ログイン試行のスロットリング。デフォルトは読み取り専用で、送信先の許可リストを使用し、完全な削除は行いません。
• 取り消し。 プロバイダー側でアプリパスワードを削除すると、誰が保持していてもそのトークンは使用できなくなります。Outlook メールボックスではパスワードの代わりに Microsoft のリフレッシュトークンを使用します。アプリを取り消すには、account.live.com/consent/Manage にアクセスするか、職場アカウントの場合は My Apps を利用してください。MAILMCP_KEY を変更すると、サーバー上のすべてのトークンが無効になります。
• レビュー。 バージョン 0.4.1（2026 年 9 月）を対象とする、社内での AI 支援によるセキュリティレビューについて、すべての指摘事項、修正、受け入れたトレードオフを公開しています：mailmcp.ai/audit。

使用統計

1 日に 1 回まで、すべてのコピーが mailmcp.ai に新しいバージョンがあるか問い合わせます。Claude Desktop は起動するたびに問い合わせます。サーバーのコピー（Vercel の本番環境、Docker、Node）は、この問い合わせとともに使用統計も送信します。ただし、無効にした場合を除きます。Claude Desktop やその他のデスクトップ（stdio）のコピーは、統計を有効にした場合にのみ送信し、起動回数にかかわらず 1 日に 1 回までです。送信される本文は次のとおりです。

{"s":1,"v":"0.13","r":"docker","d":"…"}

s はスキーマ、v はメジャー.マイナー形式のバージョン、r はランタイム（vercel、docker、node、claude-desktop、または stdio）、d は暦月ごとに同じ値を保つ数値です。この値はサーバーから外部に送信されない値（Vercel プロジェクト ID、それ以外の場合はマシン ID、またはコピーが ~/.mailmcp/stats-salt に一度だけ書き込むランダムなソルト。MAILMCP_KEY が設定されている場合は、それを組み合わせます）から計算されます。~/.mailmcp/stats-sent-* には、各インスタンスが最後に ping を送信した日が記録されます。ライセンスキー、設定、アドレス、メールボックス、コンテンツは送信されません。mailmcp.ai が保持するのは、バージョン別およびランタイム別の日次・月次件数のみです。保存された情報から、どのインストールがリクエストを送信したかを特定することはできません。ホストである Vercel は、他のウェブサイトと同様に、すべてのリクエストの IP アドレスを 1 日間ログに記録します。当社のコードが IP アドレスを保存することはありません。Vercel のプレビュー環境ではアップデートの確認のみを送信します。CI の実行やソースからのビルドでは何も送信されません。すべてのコピーは起動時に、統計が ON か OFF かを示す 1 行をログに記録します。

切り替え値（1、true、yes、または on）：MAILMCP_NO_STATS=1 または MAILMCP_STATS=0（統計を無効にします。アップデートの確認は継続します）、MAILMCP_NO_UPDATE_CHECK=1（リクエストを一切送信しません）、DO_NOT_TRACK=1（統計を無効にします）。Claude Desktop では、拡張機能の設定「匿名の使用統計」（デフォルトでオフ）と「アップデートを確認」（チェックなし。何も送信されません）を使用します。収集されるすべての情報と合計は、mailmcp.ai/stats で公開されています。

料金

無料	パーソナル、€19（買い切り）	無制限、€149（買い切り）
すべてのツールを利用できます。1 人あたり合計 2 個までメールボックスを使用できます（サーバーはトークンごとに 2 個まで確認します。0.7.0 より前に作成されたトークンでは 5 個までです）。アシスタントが作成するすべてのメッセージ（下書き、送信、転送）には「Sent with mailmcp.ai」が末尾に付加されます。	ユーザー 1 人、所有者を問わず合計 5 個までメールボックスを使用でき、署名は付きません。ご自身のサーバーまたは Claude Desktop で利用できます。	1 つの組織（会社または個人事業主とその従業員）につきサーバー 1 台。ユーザー数とメールボックス数は無制限です。

すべての 0.x アップデートが含まれます。1.0 へのアップグレードには料金が発生する場合がありますが、0.x は引き続き動作します。理由を問わず、14 日以内であれば返金します。企業向け導入は €990 です。お客様の Vercel またはクラウド環境でのオンライン導入支援 2 時間と、無制限ライセンスが含まれます。mailmcp.ai/pricing で購入できます。キーは支払いの直後に表示され、Stripe から請求書がメールで届きます。

更新

0.8 へのアップグレード。 トークンモードのサーバーでは、MAILMCP_INVITE_CODE（8 文字以上）または、意図的に公開するサーバーの場合は MAILMCP_OPEN_SIGNUP=1 が必要になりました。0.8 をデプロイする前に、いずれかを設定してください（Vercel の場合：Settings → Environment Variables → Production の順に開き、その後再デプロイします）。設定しないと、/setup でトークンが発行されなくなり、その旨が表示されます。すでに発行済みのトークンは、どちらの設定でも引き続き使用できます。変更点の全一覧は、CHANGELOG.md の 0.8.0 の項目をご覧ください。0.8 では、Microsoft サインインを通じた Outlook および Microsoft 365 のメールボックスにも対応しました。独自の Entra 登録を使う場合や、上記の停止スイッチを使う場合を除き、設定は不要です。

0.13 へのアップグレード。 設定は不要です。サーバーのコピーは、MAILMCP_NO_STATS=1 を設定しない限り、上記で説明した日次の使用統計を送信するようになりました。既存のトークンでは、セットアップページで保護レベルを選択し、すべてのアシスタントでトークンを置き換えるまで、保護はオフのままです。ChatGPT では、コネクターを更新して（Settings → Connectors → mailmcp → Refresh）、新しいツールを表示してください。Claude Desktop では、新しい mailmcp.mcpb をインストールしてください。MOVE にも UIDPLUS にも対応していない IMAP サーバーでは、ほかのメッセージに影響するリスクを避けるため、移動が拒否されるようになりました。変更点の全一覧は、CHANGELOG.md の 0.13.0 の項目をご覧ください。

リリースにはここでタグが付けられ、CHANGELOG.md に一覧表示されます。Vercel のボタンを使ってデプロイした場合、Vercel によってこのリポジトリのコピーが作成されています。そのコピーに新しいタグを取り込み（git pull https://github.com/kojott/mailmcp-dist.git main を実行してプッシュ）、Vercel にプッシュをデプロイさせてください。Docker と Node の場合は、プルして再ビルドまたは再起動してください。ロールバックするには、前のタグをデプロイします。MAILMCP_KEY が同じであれば、バージョンをまたいでもトークンは引き続き使用できます。

よくある質問

Google に「アプリ パスワード」の設定が「このアカウントではご利用いただけません」と表示されます。 2 段階認証プロセスを有効にしてページを再読み込みしてください。それでも表示されない場合は、組織のポリシーまたは高度な保護機能によってアプリ パスワードがブロックされています。

トークンを紛失しました。 トークンは復元できません。セットアップページで新しいトークンを作成し（今回は編集用パスワードを設定すると、後から読み込んで変更できます）、アシスタント側で置き換えてください。

アシスタントが独自にメールを送信できますか？ 送信を有効にしていて、かつ許可リストに登録されたアドレス宛ての場合に限り、送信できます。デフォルトでは、下書きの使用がより安全です。

添付ファイルのリンク。 ダウンロードリンクとアップロードリンクは 1 時間有効で、トークンが暗号化された形式で含まれています。そのリンクを持っている人は、1 時間の間、リンクを使用できます。

ライセンス、サポート、問題の報告

ライセンス契約は LICENSE に記載されています（英訳が先に記載され、チェコ語の原文が優先されます）。内容は、1 つのキーにつき 1 つの稼働中のインストール、再配布の禁止、別途契約を結ばずに他人のメールボックスを提供することや、mailmcp をホステッドサービスとして運用することの禁止です。ライセンスチェックや無料プランの署名を削除することは禁止されています。これはクローズドソースのソフトウェアのため、プルリクエストは受け付けていませんが、Issues でのバグ報告は歓迎します。セキュリティ上の問題は、Issue を作成せず、[email protected] にご連絡ください。プライバシーポリシー：https://mailmcp.ai/privacy、利用規約：https://mailmcp.ai/terms。

利用者向けガイド：mailmcp.ai/docs。アシスタント向けガイド：リンクを ChatGPT または Claude に貼り付けて、手順を案内してもらってください：mailmcp.ai/llms.txt。サポート：jiridolejs.cz/kontakt。

_{バージョン 0.14.1。プラハで制作。Jiří Dolejš。}