Mailsink

@mailsink/mcp

MailSink 用の Model Context Protocol サーバー — AI エージェントやテスト自動化向けの、プログラムで操作できる一時メール受信箱です。

エージェントに、使い捨てアドレスの作成、登録メールの受信待機、OTP コードやマジックリンクの抽出、使用後のクリーンアップを行うための、型付きツールを 8 つ提供します。Claude Code、Claude Desktop、Cursor、Windsurf、およびその他の MCP 対応クライアントで動作します。

インストール

npm install -g @mailsink/mcp

インストールせずに npx で実行することもできます。

npx @mailsink/mcp

API キーを取得する

1. GitHub で https://mailsink.dev/app にサインインします。

2. 一度だけ表示されるキーをコピーします。パスワードマネージャーまたは .env に保存してください。

3. MCP サーバーが読み取れるように、キーをエクスポートします。

   export MAILSINK_API_KEY="msk_..."
   

無料プランでは月 50 件の受信箱を利用でき、MCP も含まれます。Pro（$15/mo）と Team（$49/mo）では、受信箱数の上限がなくなり、メールサイズの上限が引き上げられ、TTL が延長され、リクエストレートが増加します。料金をご覧ください。

クライアントを設定する

Claude Code

claude mcp add mailsink -- npx -y @mailsink/mcp

Claude Desktop / Cursor / Windsurf

クライアントの設定ファイルにある mcpServers セクションに追加します。

{
  "mcpServers": {
    "mailsink": {
      "command": "npx",
      "args": ["-y", "@mailsink/mcp"],
      "env": {
        "MAILSINK_API_KEY": "msk_..."
      }
    }
  }
}

クライアントを再起動します。8 つのツールを備えた mailsink サーバーが表示されます。

ツール

ツール	用途
create_inbox	使い捨てアドレスを作成します。email、id、expires_at を返します。
list_inboxes	アカウントの有効な受信箱を一覧表示します。
wait_for_email	メールが届くまで最大 timeout 秒（最大 120 秒）待機します。
get_verification_code	受信箱から最新の OTP を抽出します（見つかるかタイムアウトするまでポーリングします）。
get_verification_link	最新のマジックリンクを抽出します。
list_messages	受信箱内のすべてのメッセージの概要を表示します。
get_message	ID を指定して、特定のメッセージの全文を取得します。
delete_inbox	受信箱をただちに破棄します。

エージェントの使用例

> Sign me up for Figma, capture the verification code, confirm, and
> tell me the plan once you're in.

[agent invokes]
  create_inbox()                                → [email protected]
  [agent fills the Figma signup form with that address]
  wait_for_email(inbox_id)                      → blocks 30s…
                                                → returns email + OTP
  [agent types the OTP into the Figma form]
  delete_inbox(inbox_id)                        → cleanup

Webhook の設定は不要です。IMAP の認証情報も不要です。MIME の解析も不要です。

環境変数

• MAILSINK_API_KEY (必須) — アカウントの API キーです。
• MAILSINK_API_URL (任意、デフォルトは https://api.mailsink.dev) — セルフホスト環境または開発用 API の場合に変更します。

ソース

https://github.com/heocoi/mailsink/tree/main/mcp

ライセンス

MIT — LICENSE をご覧ください。