Mailtrap MCP server

Read from the package source without running it. The installed server may list more.

• batch-send-bulk-emailwrite action

  Send a batch of bulk emails (Mailtrap bulk-stream API) in one call. Shared fields go on `base`; per-recipient overrides go in `requests[]`. Each request must include at least one of `to`/`cc`/`bcc`.

• batch-send-sandbox-emailwrite action

  Send a batch of emails in sandbox mode to a test inbox in one Mailtrap API call. Shared fields go on `base`; per-recipient overrides go in `requests[]`. Requires `sandbox_id` or the MAILTRAP_SANDBOX_ID env var.

• batch-send-transactional-emailwrite action

  Send a batch of transactional emails in one Mailtrap API call. Shared fields go on `base`; per-recipient overrides go in `requests[]`. Each request must include `to`.

• bulk-update-permissionswrite action

  Bulk create, update, or destroy permissions for an account access. Existing (resource_type, resource_id) pairs are updated; new ones are created. Set `destroy: true` to remove.

• cancel-email-campaignwrite action

  Cancel a `scheduled` email campaign, returning it to `draft`; only `scheduled` campaigns can be cancelled.

• clean-sandbox-inboxwrite action

  Delete all messages from a sandbox inbox without deleting the inbox itself

• create-company-infowrite action

  Set the company info of a sending domain, required for domain compliance verification.

• create-contactwrite action

  Create a new contact. Requires `email`; optionally accepts custom `fields`, `list_ids` to subscribe to, and `unsubscribed` to start in unsubscribed status.

• create-contact-eventwrite action

  Record a contact event (by `name` + arbitrary `params`) against a contact ID or email. Used to trigger automations.

• create-contact-exportwrite action

  Export contacts matching a set of AND-combined filters. Returns an export job; poll status with `get-contact-export` to retrieve the download URL.

• create-contact-fieldwrite action

  Create a new contact field definition. `merge_tag` must be unique and is used in template variables.

• create-contact-importwrite action

  Bulk import contacts. Returns an import job record; poll status via `get-contact-import`.

• create-contact-listwrite action

  Create a new contact list.

• create-email-campaignwrite action

  Create a new email campaign in the `draft` state; requires `name`, `domain_id`, `from_local_part`, and a `template_attributes.subject`.

• create-sandbox-inboxwrite action

  Create a new sandbox test inbox within a project. Returns SMTP credentials for the new inbox.

• create-sandbox-projectwrite action

  Create a new sandbox project to group test inboxes

• create-sending-domainwrite action

  Create a new sending domain

• create-suppressionwrite action

  Add an email address to the account's suppression list, so Mailtrap stops delivering to it.

• create-templatewrite action

  Create a new email template

• create-tracking-opt-outwrite action

  Exclude an email address from open and click tracking for a sending domain.

• create-webhookwrite action

  Create a webhook. `webhook_type` may be `email_sending`, `audit_log`, or `inbound_receiving`; for `inbound_receiving`, `inbound_inbox_id` is optional (scopes the webhook to one inbox — omit to apply to all inboxes). The response includes a `signing_secret` for verifying webhook payload signatures — this secret is returned only on creation, so store it now.

• delete-contactwrite action

  Permanently delete a contact by ID or email. Returns the deleted contact record when available.

• delete-contact-fieldwrite action

  Permanently delete a contact field definition by ID.

• delete-contact-listwrite action

  Permanently delete a contact list by ID.

• delete-email-campaignwrite action

  Delete an email campaign by ID; only a campaign in the `draft` state can be deleted.

• delete-sandbox-inboxwrite action

  Delete a sandbox inbox and all its messages

• delete-sandbox-messagewrite action

  Delete a single sandbox message

• delete-sandbox-projectwrite action

  Delete a sandbox project and all its inboxes

• delete-sending-domainwrite action

  Delete a sending domain

• delete-suppressionwrite action

  Delete a suppression by ID. Mailtrap will resume delivery to this email unless it gets suppressed again.

• delete-templatewrite action

  Delete an existing email template

• delete-tracking-opt-outwrite action

  Remove an email address from the tracking opt-out list, so open and click tracking applies to it again.

• delete-webhookwrite action

  Permanently delete a webhook by ID. Returns the deleted webhook record.

• enable-sandbox-email-addresswrite action

  Enable the receive-by-email address for a sandbox

• forward-sandbox-message

  Forward a sandbox message to an email address (counts against your monthly forwarding quota)

• get-billing-usage

  Get the current billing cycle usage for the account (sending and testing plans, limits, and current counts).

• get-company-info

  Get the company info of a sending domain, used for domain compliance verification.

• get-contact

  Get a contact by ID or email address. Returns the full contact record including list memberships, status, and custom fields.

• get-contact-export

  Get the status of a contact export job. Once `status` is `finished`, the `url` field holds the download link.

• get-contact-field

  Get a contact field definition by ID.

• get-contact-import

  Get the status of a contact import job, including created/updated/over-limit counts.

• get-contact-list

  Get a contact list by ID.

• get-email-campaignwrite action

  Get an email campaign by ID.

• get-email-campaign-statswrite action

  Get aggregated performance statistics for an email campaign; optionally narrow the window with `start_date`/`end_date` (`YYYY-MM-DD`).

• get-email-log-messagewrite action

  Get a single email log message by ID (UUID) to inspect delivery status and event history.

• get-permission-resources

  Get all resources (inboxes, projects, domains, billing, account) to which the API token has admin access, nested by hierarchy.

• get-sandbox-attachment

  Get the metadata and download URL for a single sandbox attachment.

• get-sandbox-inbox

  Get sandbox inbox details including SMTP credentials, email counts, and status

• get-sandbox-message-eml

  Get a sandbox message as an EML file payload.

• get-sandbox-message-headers

  Get the parsed mail headers for a sandbox message.

• get-sandbox-message-html

  Get the rendered HTML body of a sandbox message.

• get-sandbox-message-html-analysis

  Get HTML analysis for a sandbox message (client compatibility, problematic elements).

• get-sandbox-message-html-source

  Get the unrendered HTML source of a sandbox message.

• get-sandbox-message-raw

  Get the raw message (MIME-formatted) for a sandbox message.

• get-sandbox-message-spam-score

  Get the SpamAssassin spam report for a sandbox message (score, rules, report).

• get-sandbox-message-text

  Get the plain-text body of a sandbox message.

• get-sandbox-messages

  Get list of messages from the sandbox test inbox

• get-sandbox-project

  Get a sandbox project by ID, including its inboxes and email counts

• get-sending-domain

  Get a sending domain by ID and its verification status. Optionally include DNS setup instructions via include_setup_instructions.

• get-sending-stats

  Get email sending statistics (delivery, bounce, open, click, spam rates) for a date range. Optionally break down by domain, category, email service provider, or date.

• get-template

  Get a single email template by ID, including subject, category, and HTML/text body.

• get-webhook

  Get a single webhook by ID.

• list-account-accesses

  List account accesses (users, invites, API tokens) for the account. Optionally scope by domain UUIDs, inbox IDs, or project IDs. Requires account admin/owner permissions.

• list-accounts

  List Mailtrap accounts accessible to the API token, with each account's access levels.

• list-api-tokens

  List all API tokens for the account.

• list-contact-fields

  List all contact field definitions for the account.

• list-contact-lists

  List all contact lists for the account. Optionally filter by name with `search` (case-insensitive match).

• list-email-campaignswrite action

  List the account's email campaigns, newest first, with page-token pagination (`token`, `per_page`). Optionally filter by name with `search`.

• list-email-logswrite action

  List sent email logs (delivery history) with optional pagination and filters; use to debug delivery issues.

• list-sandbox-attachments

  List all attachments on a sandbox message.

• list-sandbox-projects

  List all sandbox projects and their inboxes in your Mailtrap account

• list-sandboxes

  List all sandboxes accessible to the API token across projects

• list-sending-domains

  List sending domains and their DNS verification status

• list-suppressions

  List or search suppressions. Optionally filter by email. Returns up to 1000 suppressions per call.

• list-templates

  List all email templates

• list-tracking-opt-outs

  List email addresses excluded from open and click tracking. Returns up to 1000 records per call.

• list-webhooks

  List all webhooks for the account.

• mark-sandbox-as-read

  Mark all messages in a sandbox as read

• remove-account-accesswrite action

  Remove an account access by ID. For User specifiers this revokes permissions; for Invite or ApiToken specifiers it removes the specifier itself. Requires admin/owner.

• reset-email-campaignwrite action

  Reset a `scheduled` email campaign back to `draft`; only `scheduled` campaigns can be reset.

• reset-sandbox-credentials

  Reset the SMTP credentials for a sandbox

• reset-sandbox-email-addresswrite action

  Generate a new receive-by-email address for a sandbox

• schedule-email-campaignwrite action

  Schedule a `draft` email campaign to start sending at `datetime` (ISO 8601, must be in the future and no more than 1 month ahead); only `draft` campaigns can be scheduled.

• send-emailwrite action

  Send an email to your recipient email address using Mailtrap Email API. You can send emails to multiple recipients at once.

• send-sandbox-emailwrite action

  Send an email in sandbox mode to a test inbox without delivering to your recipients

• send-sending-domain-setup-instructionswrite action

  Email DNS setup instructions for a sending domain to a given address.

• show-sandbox-email-messagewrite action

  Show sandbox email message details and content from the sandbox test inbox. Optionally include spam report (SpamAssassin score) and HTML analysis (client compatibility) for email testing workflows.

• start-email-campaignwrite action

  Start sending a `draft` email campaign immediately; only `draft` campaigns can be started.

• terminate-email-campaignwrite action

  Terminate an email campaign that is currently sending (`started`, `queued`, or `paused`), aborting the in-flight send.

• update-company-infowrite action

  Update the company info of a sending domain.

• update-contactwrite action

  Update a contact (identified by ID or email). `list_ids` replaces the membership set; `list_ids_included`/`list_ids_excluded` add/remove without disturbing the rest.

• update-contact-fieldwrite action

  Update a contact field definition. Any combination of `name`, `merge_tag`, or `data_type` can be changed.

• update-contact-listwrite action

  Rename an existing contact list.

• update-email-campaignwrite action

  Update a `draft` email campaign; only the provided fields change, and campaigns in any other state cannot be updated.

• update-sandbox-inboxwrite action

  Update a sandbox inbox name or email username

• update-sandbox-messagewrite action

  Mark a sandbox message as read or unread

• update-sandbox-projectwrite action

  Rename an existing sandbox project

• update-sending-domainwrite action

  Update a sending domain's tracking and inbound settings.

• update-templatewrite action

  Update an existing email template

• update-webhookwrite action

  Update a webhook's mutable fields (`url`, `active`, `payload_format`, `event_types`, `inbound_inbox_id`). `webhook_type`, `sending_stream`, and `domain_id` cannot be changed after creation.

• Code scan275 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 4 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year; website matches verified namespace10/10

Mailtrap: common questions

Is Mailtrap MCP server safe?

Yes, by our scan: it is graded A (86/100). Read the Mailtrap safety report

How do I install Mailtrap?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Mailtrap need an API key?

Yes. The registry entry asks for MAILTRAP_API_TOKEN.

Is Mailtrap maintained?

The last commit was 5 days ago (2026-09-16). The latest release is v0.9.0.