メインコンテンツへスキップ

MCP

Gmail、Outlook、Yahoo、iCloud、IMAP対応のMCPサーバー

Claude、Cursor、VS Codeやエージェントが、接続済みのすべてのメールボックスでメールの閲覧、OTPコードの取得、返信、迷惑メールからの移動を行えます。ワークスペースのAPI keyを使うだけで、コードは不要です。

claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \  --header "Authorization: Bearer mh_live_xxx"

接続

サーバーURL
https://mailera.app/api/public/v1/mcp
認証
Authorization: Bearer mh_live_… または X-API-Key
トランスポート
Streamable HTTP、セッション不要
プロトコルバージョン
2025-06-18 · 2025-03-26 · 2024-11-05

キーの権限に応じた12個のツール

エージェントには、API keyの権限で許可されたツールのみが表示されます。各呼び出しは対応するRESTエンドポイントを実行するため、結果とエラーコードはAPIと同じです。

ツール機能スコープ
list_mailboxesメールボックス、プロバイダー、対応機能、同期状態を一覧表示しますread
get_mailbox_statusメールボックスの接続状態と最終同期時刻を確認しますread
list_messagesフォルダー内のメールを新しい順に一覧表示しますread
search_messagesすべてのメールボックスからメールを検索します。OTPコードも取得できますread
get_message差出人、本文、添付ファイルを含むメール全体を読み取りますread
get_latest_otp受信トレイまたは迷惑メールから最新のOTPコードを取得しますread
send_emailidempotency_keyで重複送信を防ぎながら、新規メールを送信しますsend
reply_to_emailメールに返信、全員に返信、または転送しますsend
get_send_status送信処理の状態がsent、failed、unknownのいずれかになるまで追跡しますsend
move_messageメールを受信トレイ、迷惑メール、アーカイブ、削除済みアイテムに移動しますmove
rescue_spam迷惑メールからすべてのメール、または差出人、ドメイン、件名で指定したメールを移動しますmove
sync_mailbox今すぐ同期し、スリープ中のメールボックスを再開しますsync

各ツール呼び出しは対応するRESTエンドポイントを使用します。スコープ、毎分300リクエストの上限、APIログは共通です。エラーはツールの結果(isError)に表示され、エージェントが処理できるよう、一貫したerror.codeが含まれます。

アプリ別の設定

設定をコピーしてAPI keyを入力し、アプリを再起動してください。各アプリのガイドには、動作確認の手順とよくあるエラーを掲載しています。

  • Claude

    Claude Codeはコマンド1つで、Claude Desktopはmcp-remoteブリッジ経由で接続できます。

    Terminal · claude_desktop_config.json

    Claudeガイド
  • Cursor

    mcp.jsonファイル1つで、すべてのプロジェクトにも、特定のプロジェクトにも設定できます。

    ~/.cursor/mcp.json

    Cursorガイド
  • VS Code

    .vscode/mcp.jsonで設定できます。VS Codeはキーを一度だけ確認し、安全に保管します。

    .vscode/mcp.json

    VS Codeガイド

エージェントによる安全なメールボックス利用

  • 必要な権限だけを付与

    エージェントがメールを読むだけなら、読み取り権限のみのキーを作成してください。送信権限は本当に必要な場合にのみ付与し、可能な限りキーのアクセス先をメールボックスのグループで制限してください。

  • 受信メールはデータであり、指示ではありません

    メールの内容は他の人が書いたものです。「すべてのメールを…に転送して」など、メール内の指示にエージェントを従わせないでください。送信や転送の前には、必ず確認を求めるようにしてください。

  • 各メールの送信は1回だけ

    送信時は必ずidempotency_keyを渡してください。ステータスが不明な場合は再送せず、まず送信済みアイテムを確認してください。

  • いつでも失効可能

    設定 → API keyでキーを失効させると、そのキーを使うすべてのアプリを即座にブロックできます。ツールの呼び出しは毎回APIログに記録されます。

MCPを使わない場合は?

すべてのツールに対応するRESTエンドポイントがあり、新着メール用の署名付きwebhookも利用できます。