ClaudeIMAPMCPTutorial

Claude IMAPコネクタ:任意のIMAPメールボックスをClaudeに接続する

IMAP/SMTPが使えるあらゆるメールボックス向けにClaude IMAPコネクタを設定する方法。サーバー設定、アプリ パスワード、TLSポート、セキュリティの考え方、制限事項、トラブルシューティングまで解説します。

MCPEmailsを介してIMAPとSMTPのメールボックスに接続したClaude

Claude IMAPコネクタを使うと、Claudeに標準の連携がないメールボックスでもClaudeから扱えるようになります。Fastmail、iCloud Mail、Yahoo、Zoho、Yandex、独自ドメインのメールボックス、そしてIMAPとSMTPを提供しているほぼすべてのプロバイダーが対象です。

Claudeがメールサーバーにログインしたり、メールボックスのパスワードを直接扱ったりすることはありません。間に入るのがMCPEmailsです。受信メールにはIMAP、送信メールにはSMTPでプロバイダーに接続し、その結果を一貫したModel Context ProtocolのツールとしてClaudeに提示します。この区別が重要です。IMAPとSMTPがメールボックスを扱い、MCPがClaudeに読む、検索する、返信する、移動するといった安全で構造化された操作を与えます。

このガイドでは汎用コネクタとClaude側の設定を扱います。iCloudまたはFastmailをお使いで、それぞれのアプリ パスワードの画面やサーバー名を正確に知りたい場合は、iCloud、Fastmail、IMAPのプロバイダー別ガイドを並べて開いておいてください。

Claude IMAPコネクタが実際にしていること

接続は3つの部分からなります。

  1. メールプロバイダーが、メッセージの閲覧と整理のためのIMAPと、送信のためのSMTPを提供します。
  2. MCPEmailsがメールの認証情報を暗号化して保持し、それらのサーバーと通信して、その応答を予測可能なメールツールに変換します。
  3. ClaudeがMCPエンドポイントに接続し、承認したスコープで許可されたツールだけを呼び出します。

したがってClaudeには、IMAPライブラリもSMTPの設定もプロンプト内のパスワードも必要ありません。接続後は、inbox_listでメールボックスを見つけ、email_readで一覧、閲覧、検索、添付ファイルの取得を行い、email_composeで送信、返信、転送し、email_organizeでメッセージの移動、コピー、フラグ付け、アーカイブができます。フォルダー、下書き、予約送信、連絡先、削除は別のツールが担当します。全リストはツールリファレンスにあります。

設定の前に用意するもの

次の値をメールプロバイダーのヘルプページまたは管理者から集めてください。プロバイダーごとの確認済みIMAP/SMTP設定も参照できます。

  • メールアドレス: 例:you@example.com。接続した受信トレイに表示されるアドレスです。
  • ログインユーザー名: 通常はメールアドレス全体です。独自ドメインのホストによっては、別のIMAP/SMTPユーザー名が発行されます。
  • IMAPホストとポート: 例:imap.example.com、ポート993(暗黙的TLSのIMAP)。この接続が閲覧、検索、フォルダー、メッセージ操作を担当します。
  • SMTPホストとポート: 例:smtp.example.com、ポート465または587。ポート465は暗黙的TLS、587はSTARTTLSでアップグレードします。この接続が送信、返信、転送を担当します。
  • パスワード: メールクライアント用に作成した、取り消し可能なアプリ パスワードが望ましいです。

プロバイダーが設定を公開している場合は、ドメインからサーバー名を推測しないでください。メールのホスティングはWebサイトのホスティングと別であることが多く、独自ドメインのアドレスでは、表示上のアドレスと異なるプロバイダー固有のログインを使うことがあります。

プロバイダーが対応していれば、必ずアプリ パスワードを使ってください。アカウント本体のパスワードとは別のもので、ログインに使うパスワードを変えずに取り消せます。多くのプロバイダーは、作成の前に2要素認証を必須にしています。先にメール設定でIMAPアクセスを有効にする必要があるプロバイダーもあります。

MCPEmailsにはiCloud、Yahoo、Zoho、Yandexのプリセットと、専用のFastmailアプリ パスワードフローがあります。これらを選ぶと既知のホストとポートが自動で入ります。ほかのプロバイダーや自前のメールサーバーではGeneric IMAP(汎用IMAP)を選び、値を自分で入力してください。汎用IMAPの設定ページをご覧ください。

ステップ1:IMAP/SMTPメールボックスを接続する

  1. MCPEmailsのアカウントを作成またはログインし、ダッシュボード → 受信トレイ → 受信トレイを接続を開きます。
  2. 該当するプロバイダー名があればそれを選びます。なければIMAP / SMTPを選びます。
  3. メールアドレスとアプリ パスワードを入力します。汎用コネクタでは、IMAPホストとポート、SMTPホストとポート、ホストから別のログインユーザー名を渡されている場合はそれも入力します。
  4. 接続を保存します。MCPEmailsは受信トレイを保存する前にIMAPサーバーに対して認証情報を検証するので、ログインの拒否やTLSエンドポイントへの到達不能は、後からClaudeで表面化するのではなく、ここで失敗します。

一般的な安全なデフォルトはIMAPが993、SMTPが465または587です。これらは互換ではありません。プロバイダーが文書化しているポートとセキュリティモードを使ってください。MCPEmailsはSMTPポート587をSTARTTLSとして、設定されたそのほかのSMTPポートを暗黙的TLSとして扱います。TLSに対応していない接続は拒否されます。

ステップ2:MCPEmailsをClaudeのコネクタとして追加する

メールボックスを接続したら、ClaudeをMCPEmailsに向けます。

  1. claude.aiでカスタマイズ → コネクタを開きます。
  2. コネクタを追加を選び、https://www.mcpemails.com/api/mcpを入力します。
  3. 接続を選び、MCPEmailsにログインして、ワークフローに必要な権限だけを承認します。

たとえば要約用なら読み取りと検索のアクセスは必要ですが、送信や削除のアクセスは不要です。返信のワークフローには送信アクセスが必要です。フォルダー管理と完全削除には独自のスコープがあるので、本当に必要になるまで破壊的な操作を使えないままにしておけます。クライアント側の流れの詳細はClaudeのメール接続ガイドをご覧ください。

次に、簡単な動作確認をします。

Use inbox_list to find my IMAP inbox. List my five newest unread messages and summarize them. Do not send, move, or delete anything.

inbox_listから始めると、コピーしたUUIDに頼らずにClaudeが正しいinbox_idを取得できます。

ClaudeがIMAPでできること

接続が動けば、Claudeは次のことができます。

  • プロバイダーからライブで取得したメッセージの一覧表示と閲覧。
  • 送信者、受信者、件名、本文テキスト、既読状態、フラグの状態、日付による検索。
  • 文書化されたサイズと形式の制限内での、対応する添付ファイルのダウンロードまたは抽出。
  • SMTPによる新規メッセージの送信、あるいは該当するメッセージの文脈を保ったままの返信と転送。
  • IMAPフォルダー内でのメールの移動、コピー、フラグ付け、アーカイブ、整理。
  • 下書きの作成と管理、メッセージの予約送信、ツールが対応している範囲での連絡先の検索。
  • メールのゴミ箱への移動、または明示的な削除権限とpermanent: trueによるIMAP上での完全削除。

最後の機能には注意が必要です。IMAPの完全削除はゴミ箱を経由せず、元に戻せない場合があります。MCPEmailsは削除を独立した破壊的ツールとして公開し、確認の挙動はMCPクライアントが制御しますが、それでもdelete:emailは本当に必要なワークフローにだけ付与してください。

IMAPの重要な制限事項

IMAPコネクタは幅広く使えますが、すべてのプロバイダーが同じになるわけではありません。

  • 受信メールのプッシュ通知はありません: MCPEmailsはリクエスト/レスポンスのみです。Webhookを送ったり、メッセージの到着時にClaudeを起動したりはしません。自動化したワークフローは、未読メールの一覧取得などをスケジュールに沿ってポーリングする必要があります。
  • 検索はトランスポートによって異なります: 送信者、件名、テキスト、日付の構造化フィルターはプロバイダーをまたいで動きますが、汎用IMAPはhas_attachment検索フィルターに対応していません。プロバイダー固有の検索構文は移植できません。
  • フォルダーはGmailのラベルではありません: IMAPはメッセージをフォルダー間で移動しますが、Gmailは1つのメッセージに複数のラベルを付けられます。実用上の違いはGmailのラベルとIMAPのフォルダーで説明しています。
  • 送信にはSMTPが必要です: IMAPのログインが成功しても、証明されるのはClaudeが受信メールに届くことだけで、SMTPのホスト、ポート、送信権限が正しいことではありません。返信のワークフローに頼る前に、無害な送信メッセージを1通試してください。
  • プロバイダーのポリシーは引き続き適用されます: メールボックスの容量、送信制限、同時接続数の制限、スパム対策、管理者による制限はそのまま有効です。

Claude IMAP接続のトラブルシューティング

受信トレイの接続時に「Authentication failed」(認証に失敗しました)と出る

プロバイダーのWebサイトで使うパスワードではなく、アプリ パスワードを使ってください。プロバイダーが要求している場合は、2要素認証とIMAPアクセスが有効になっているか確認します。生成されたパスワードを、前後の空白を含めずにもう一度コピーしてください。独自ドメインのアドレスなら、ログインユーザー名がメールアドレス全体なのか、別のアカウント名なのかを確認します。

サーバーがタイムアウトする、またはTLSに失敗する

ホスト名のつづりを確認し、プロバイダーが文書化している安全なポートを使ってください。IMAPは993から始め、SMTPは文書化された465または587を使います。Webサイトのホスト名、コントロールパネルのホスト名、ドメインそのものは、必ずしもメールサーバーではありません。自前のサーバーの場合は、ファイアウォールがネットワーク外からの接続を受け付けていること、TLS証明書がメールのホスト名と一致していることも確認してください。

Claudeは読めるが送信できない

IMAPの設定は動いていますが、SMTPは別物です。SMTPのホスト名とポートを再確認し、認証情報にSMTPまたは「メール」のアクセスがあること、プロバイダーがそのFromアドレスからの認証済み送信を許可していることを確認します。たとえばFastmailのアプリ パスワードは、読み取り専用ではなくMail (IMAP/SMTP)のアクセスで作成する必要があります。

Claudeがメールボックスを見つけられない

Claudeにもう一度inbox_listを呼ぶよう頼んでください。受信トレイが表示されない場合は、MCPEmailsのダッシュボードでその状態を確認し、アプリ パスワードが取り消しまたは更新されていたら再接続します。受信トレイは表示されるのに操作が拒否される場合は、Claudeのコネクタを再接続するか、必要なスコープを付けてAPIキーを更新してください。

検索結果が想定より狭い

まずfrom、subject、text、since、beforeなどの構造化フィールドから始め、必要に応じて検索するフォルダーを指定します。Gmailの演算子構文を汎用IMAPの検索にそのまま持ち込んで、同じ挙動を期待しないでください。添付ファイルの有無によるフィルターは汎用IMAPでは無視されることも覚えておいてください。

セキュリティ:認証情報はClaudeに渡らない

MCPEmailsは、今後の呼び出しに必要なOAuthトークンまたはIMAPのアプリ パスワードを、AES-256-GCMで保存時に暗号化して保持します。通常のメールボックスの内容は、ツールの実行時にライブで取得され、呼び出しの間で永続化されません。通信はTLSを使い、アプリ パスワードはプロバイダー側で取り消すことも、受信トレイをダッシュボードから切断することもできます。

チャットやローカル設定にメールの認証情報を貼り付ける代わりにMCPブリッジを使う主な理由は、この明確な境界にあります。Claudeが受け取るのはスコープで制限されたメール機能であって、メールボックスの鍵ではありません。保存と脅威モデルの詳細は、「メールは保存されない」ことがなぜ重要かとセキュリティの概要をご覧ください。

まとめ

Claude IMAPコネクタとは、IMAP/SMTPのメールボックス接続をMCPツールとしてClaudeに提示するものです。安全なサーバー設定を集め、取り消し可能なアプリ パスワードを作り、MCPEmailsで受信トレイを接続し、Claudeにhttps://www.mcpemails.com/api/mcpを追加します。まず読み取り専用のアクセスを試し、送信や破壊的なスコープは意図して追加し、プロバイダーが接続を拒否する場合は上のトラブルシューティングのチェックリストを使ってください。

試してみますか?IMAPの受信トレイを接続するか、iCloudとFastmailの詳細はプロバイダー別の設定ガイドをご覧ください。

Asgeir Albretsen
執筆
Asgeir Albretsen

Asgeir builds MCPEmails — the bridge that lets AI agents read, search, and send real email over the Model Context Protocol. He writes about agents, email infrastructure, and developer experience.

エージェントに受信トレイを

Gmail、Outlook、Fastmail、あらゆるIMAPアカウントを、数分でAIエージェントに接続できます。