Skip to main content
Glama
pijusz

mcpj-mailtrap

by pijusz

クイックスタート

1. APIトークンを取得

Mailtrap API TokensからAPIトークンを取得します。

2. Claude Codeに追加

最小構成

claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- npx mcpj-mailtrap

完全構成

claude mcp add mailtrap \
  -e MAILTRAP_API_TOKEN=your_token \
  -e MAILTRAP_SENDING_TOKEN=your_sending_token \
  -e MAILTRAP_ACCOUNT_ID=12345 \
  -e MAILTRAP_DEFAULT_FROM_EMAIL=noreply@yourdomain.com \
  -e MAILTRAP_TEST_INBOX_ID=12345 \
  -- npx mcpj-mailtrap

これで完了です。Claude Codeを再起動するとツールが利用可能になります。

Bunをお持ちの場合は、bunx mcpj-mailtrap@latestでも動作します。 npxで実行する場合はNode 18+が必要です。

Claude Desktop / Cursor

最小構成

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token"
      }
    }
  }
}

完全構成

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token",
        "MAILTRAP_SENDING_TOKEN": "your_sending_token",
        "MAILTRAP_ACCOUNT_ID": "12345",
        "MAILTRAP_DEFAULT_FROM_EMAIL": "noreply@yourdomain.com",
        "MAILTRAP_TEST_INBOX_ID": "12345"
      }
    }
  }
}

Releasesからビルド済みバイナリをダウンロードします:

プラットフォーム

ファイル

macOS (Apple Silicon)

mcpj-mailtrap-darwin-arm64

macOS (Intel)

mcpj-mailtrap-darwin-x64

Linux

mcpj-mailtrap-linux-x64

Windows

mcpj-mailtrap-windows-x64.exe

macOS / Linux:

curl -Lo mcpj-mailtrap https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-darwin-arm64
chmod +x mcpj-mailtrap
sudo mv mcpj-mailtrap /usr/local/bin/
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- /usr/local/bin/mcpj-mailtrap

Windows (PowerShell):

Invoke-WebRequest -Uri "https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\mcpj-mailtrap.exe"
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- "%LOCALAPPDATA%\mcpj-mailtrap.exe"

Related MCP server: Inbound Email MCP Server

ツール (48)

アナリティクス

ツール

説明

get_stats

送信統計 — 配信率、バウンス率、開封率、クリック率、スパム率。ドメイン、カテゴリ、ESP、日付でグループ化

メールログ

ツール

説明

get_email_logs

ステータス、ストリーム、日付でフィルタリングして送信メールを一覧表示。カーソルベースのページネーション

get_email_log

配信イベントのタイムラインを含む単一メッセージの詳細

get_suppressions

抑制されたメールを一覧表示(バウンス、スパム報告、配信停止)

delete_suppression

抑制されたアドレスへの送信を再び有効にする

check_list_hygiene

コンタクトリストに残っている抑制されたメールを検出し、具体的なクリーンアップアクションを提案

送信

ツール

説明

send_email

トランザクションまたはバルクストリームで送信。HTML、テキスト、テンプレートに対応

batch_send

1リクエストで最大500通のメールを送信

send_test_email

テスト用にサンドボックス受信トレイへ送信。受信トレイと送信者の環境変数デフォルトを設定可能

テンプレート

ツール

説明

list_templates

すべてのメールテンプレートを一覧表示

get_template

HTML/テキスト本文を含むテンプレートの詳細を取得

create_template

新しいテンプレートを作成

update_template

既存のテンプレートを更新

delete_template

テンプレートを削除

render_react_email

react-emailコンポーネントファイル(.tsx、.jsx、.js、.mjs)をHTML + プレーンテキストにレンダリング

コンタクト

ツール

説明

create_contact

メール、カスタムフィールド、リストメンバーシップを持つコンタクトを作成

get_contact

UUIDまたはメールでコンタクトを取得

update_contact

コンタクトのフィールド、リストメンバーシップ、購読ステータスを更新

delete_contact

コンタクトを削除

trigger_contact_event

コンタクトのオートメーションをトリガー

list_contact_lists

すべてのコンタクトリストを一覧表示

get_contact_list

単一のコンタクトリストを取得

create_contact_list

新しいコンタクトリストを作成

update_contact_list

コンタクトリストの名前を変更

delete_contact_list

コンタクトリストを削除

manage_contact_field

カスタムコンタクトフィールドの一覧、取得、作成、更新、削除

import_contacts

最大5万件のコンタクトを一括インポート、またはインポートステータスの確認

export_contacts

コンタクトのエクスポートを開始、またはエクスポートステータスの確認

メールサンドボックス

ツール

説明

list_projects

受信トレイ付きのサンドボックスプロジェクトを一覧表示

get_project

単一のプロジェクトを取得

manage_project

プロジェクトの作成、更新、削除

list_inboxes

すべてのサンドボックス受信トレイを一覧表示

get_inbox

受信トレイの詳細を取得(デフォルトでは認証情報は伏せ字)

manage_inbox

作成、更新、クリーンアップ、既読マーク、認証情報のリセット、削除

get_messages

サンドボックス受信トレイ内のメッセージを一覧表示

get_message

HTML/テキスト/raw/EML形式でメッセージ本文を取得。添付ファイルも任意で取得可能

analyze_message

スパムスコア + HTML分析 + ヘッダーレポートの複合レポート

forward_message

テストメッセージをメールアドレスに転送

ドメイン

ツール

説明

list_domains

DNSステータス付きで送信ドメインを一覧表示

get_domain

DNSレコードを含むドメインの詳細を取得

manage_domain

送信ドメインの作成または削除

send_domain_setup_instructions

DNS設定手順を同僚にメールで送信

アカウント

ツール

説明

list_accounts

アカウントを一覧表示、またはIDで取得

get_billing_usage

プランの制限と現在の使用量

manage_account_access

権限の一覧、削除、更新、リソースの表示

manage_api_token

APIトークンの一覧、取得、作成、削除、リセット

設定

変数

必須

デフォルト

説明

MAILTRAP_API_TOKEN

必須

—

mailtrap.io/api-tokensの一般APIトークン

MAILTRAP_SENDING_TOKEN

任意

MAILTRAP_API_TOKEN

トランザクションおよびバルクsend.apiリクエスト用の別トークン

MAILTRAP_ACCOUNT_ID

任意

自動検出

デフォルトのアカウントID

MAILTRAP_DEFAULT_FROM_EMAIL

任意

—

send_email / send_test_emailのデフォルト送信者メール

MAILTRAP_TEST_INBOX_ID

任意

—

send_test_emailのデフォルトサンドボックス受信トレイID

DEBUG

任意

—

デバッグログを有効にする

アップデート

npx @latestを使用(推奨): 常に最新バージョンを取得できます — 手動アップデートは不要です。

バイナリを使用: サーバーは起動時に新しいリリースを確認し、古い場合はstderrにログを出力します:

[mcpj-mailtrap] Update available: v0.2.0 (current: v0.1.0)

インストール済みバージョンの確認:

mcpj-mailtrap --version

開発

Bunが必要です。

git clone https://github.com/pijusz/mcp-mailtrap.git
cd mcp-mailtrap
bun install
bun test           # tests
bun run build      # standalone binary
bun run inspect    # MCP Inspector
bun run check      # biome format + lint

ライセンス

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Enables interaction with Mailosaur email and SMS testing services, allowing message management, server configuration, file downloads, spam analysis, and TOTP code retrieval via natural language.
    29
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to interact with Mailjet's contact, campaign, segmentation, statistics, and workflow APIs for managing email marketing operations through natural language.
    165 npm
    13
    Apache 2.0