Skip to main content
Glama
pijusz

mcpj-mailtrap

by pijusz

Быстрый старт

1. Получите свой API-токен

Получите API-токен на странице Mailtrap API Tokens.

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 — инструменты станут доступны.

Также работает с bunx mcpj-mailtrap@latest, если у вас установлен Bun. Требуется Node 18+ при запуске через npx.

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

Отправка до 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

Создание контакта с email, пользовательскими полями, членством в списках

get_contact

Получение контакта по UUID или email

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

Массовый импорт до 50 000 контактов или проверка статуса импорта

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

Пересылка тестового сообщения на email

Домены

Инструмент

Описание

list_domains

Список доменов отправки со статусом DNS

get_domain

Детали домена, включая DNS-записи

manage_domain

Создание или удаление домена отправки

send_domain_setup_instructions

Отправка инструкций по настройке DNS коллеге по email

Аккаунты

Инструмент

Описание

list_accounts

Список аккаунтов или получение одного по ID

get_billing_usage

Лимиты тарифа и текущее использование

manage_account_access

Список, удаление, обновление прав, просмотр ресурсов

manage_api_token

Список, получение, создание, удаление или сброс API-токенов

Конфигурация

Переменная

Обязательная

По умолчанию

Описание

MAILTRAP_API_TOKEN

Да

—

Основной API-токен с mailtrap.io/api-tokens

MAILTRAP_SENDING_TOKEN

Нет

MAILTRAP_API_TOKEN

Отдельный токен для транзакционных и массовых запросов send.api

MAILTRAP_ACCOUNT_ID

Нет

автоопределение

ID аккаунта по умолчанию

MAILTRAP_DEFAULT_FROM_EMAIL

Нет

—

Email отправителя по умолчанию для send_email / send_test_email

MAILTRAP_TEST_INBOX_ID

Нет

—

ID ящика песочницы по умолчанию для send_test_email

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