de en es ja ko ru zh

mcpj-mailtrap

Name: mcpj-mailtrap
Author: pijusz

by pijusz

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

빠른 시작

1. API 토큰 받기

Mailtrap API 토큰에서 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`	한 번의 요청으로 최대 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`	최대 50,000명의 연락처 일괄 가져오기 또는 가져오기 상태 확인
`export_contacts`	연락처 내보내기 시작 또는 내보내기 상태 확인

이메일 샌드박스

도구	설명
`list_projects`	받은편지함이 포함된 샌드박스 프로젝트 목록
`get_project`	단일 프로젝트 조회
`manage_project`	프로젝트 생성, 업데이트 또는 삭제
`list_inboxes`	모든 샌드박스 받은편지함 목록
`get_inbox`	받은편지함 상세 정보 조회 (자격 증명은 기본적으로 숨김)
`manage_inbox`	생성, 업데이트, 정리, 읽음 표시, 자격 증명 재설정 또는 삭제
`get_messages`	샌드박스 받은편지함의 메시지 목록
`get_message`	HTML/텍스트/원본/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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

MailMCP
io.mailmcp
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Email Communication
1
MarleyFetch
com.marleyfetch
Let AI agents send email from your own Gmail, Microsoft 365 or SMTP inbox, with guardrails.
Email Communication
1
Email Inbox API + Sending by SendmuxOAuth
io.github.Sendmux
AI email inbox and sending tools with attachments, search, live events, and webhooks.
Email Communication
265
Send Email A
io.github.hal9ai
Send emails from natural language prompts.
Email App Automation
1

Related MCP Servers

Mailtrap Email Sending
Communication App Automation
mailtrap
A
license
A
quality
A
maintenance
Integrates with Mailtrap Email Platform to enable sending transactional emails via API.
Updated 18 hours ago (2026-10-09 17:16 UTC)
8
238 npm
65
MIT
Inbound Email MCP Server
Communication App Automation Developer Tools
inboundemail
F
license
B
quality
C
maintenance
Enables AI assistants to interact with the Inbound Email API to manage domains, endpoints, and email communications. Users can send or schedule emails, manage webhooks, and retrieve email threads through natural language commands.
Updated 9 days ago (2026-10-01 22:51 UTC)
14
2
-
Mailosaur MCP
Email Testing & QA Tools
MrNewDelhi
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.
Updated 5 months ago (2026-05-18 05:59 UTC)
29
MIT
Mailjet MCP Serverofficial
Email Marketing
mailgun
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.
Updated 2 months ago (2026-08-12 13:01 UTC)
165 npm
13
Apache 2.0