How to connect Mailtrap MCP with VS Code

Trusted by teams at
AWS
Glean
Zoom
Airtable

30 min · no commitment · see it on your stack

Mailtrap logo
VS Code logo
divider

How to connect Mailtrap MCP with VS Code

VS Code is the most popular code editor out there. With its recent AI makeover, it can do more than just help you write code. You can connect your applications to it and let LLMs automate many of the mundane tasks in your workflow.

In this guide, I will explain how to connect Mailtrap with VS Code in the most secure and robust way possible via Composio.

Also integrate Mailtrap with

Why use Composio?

Composio provides:

  • Access to 1,000+ managed apps from a single MCP endpoint. This makes it convenient for agents to run cross-app workflows.
  • Programmatic tool calling. Allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool response handling outside the LLM context. This minimizes context bloat from large tool responses.
  • Dynamic just-in-time access to thousands of tools across hundreds of apps. Composio loads the tools your agent needs, so LLMs are not overwhelmed by tools they do not need.

Integrate Mailtrap MCP with VS Code

1. Install with one click

Click the button below to add Composio to VS Code. You will be prompted to authorize. This requires VS Code 1.99+ with GitHub Copilot.

+Install in VS Code

2. Or add manually

Open or create .vscode/mcp.json in your project root and add the following configuration:

bash
{
  "servers": {
    "composio": {
      "type": "http",
      "url": "https://connect.composio.dev/mcp"
    }
  }
}

3. Authorize

Click the install button to authorize VS Code to connect to Composio. VS Code will detect OAuth and prompt you to sign in.

VS Code MCP server install screen for Composio

A browser window will open to authorize.

Composio authorization browser window

4. Authenticate Mailtrap and start working

Back in VS Code chat, ask the agent to connect to Mailtrap or give it any Mailtrap-related task.

For example, ask it to:

  • "Send a test email to marketing team"
  • "List all emails sent from Mailtrap today"
  • "Create a new inbox for transactional testing"

It will prompt you to authenticate and authorize access to Mailtrap.

That is it. Composio tools are now available in VS Code, and your Mailtrap account is ready to use.

Supported Tools & Triggers

Tools
Clean InboxTool to clean an inbox in Mailtrap by deleting all messages.
Create ContactTool to create a new contact in Mailtrap.
Create Contact EventTool to create a contact event in Mailtrap.
Create Contact ExportTool to create a contact export job for a Mailtrap account.
Create Contact FieldTool to create a custom contact field in Mailtrap.
Create Contact ListTool to create a new contact list in Mailtrap.
Create Email TemplateTool to create a new email template in Mailtrap account.
Create Sending DomainTool to create a new sending domain in Mailtrap.
Delete ContactTool to delete a contact from a Mailtrap account.
Delete Contact FieldTool to delete a contact field by its ID.
Delete Contact ListTool to delete a contact list by its ID.
Delete Email TemplateTool to delete an email template from a Mailtrap account.
Delete ProjectTool to delete a project from Mailtrap.
Delete Sending DomainTool to delete a sending domain from a Mailtrap account.
Get Billing UsageTool to retrieve current billing cycle usage for an account.
Get ContactTool to retrieve a contact by UUID or email address from Mailtrap.
Get Contact ExportTool to retrieve the status of a contact export.
Get Contact FieldTool to retrieve contact field details by field ID.
Get Contact Import StatusTool to retrieve the status of a contact import operation.
Get Contact ListTool to retrieve a specific contact list by its ID.
Get Email TemplateTool to retrieve details of a specific email template by ID.
Get Inbox AttributesTool to retrieve inbox attributes from Mailtrap.
Get Message HTML BodyTool to retrieve the HTML body of a message from Mailtrap.
Get Permission ResourcesTool to retrieve all resources in account for permission management.
Get Project by IDTool to retrieve project details from Mailtrap by project ID.
Get Sending DomainTool to retrieve sending domain details from Mailtrap.
Get Sending StatsTool to retrieve email sending statistics from Mailtrap for a specific account.
Get Sending Stats by CategoriesTool to retrieve email sending statistics grouped by categories.
Get Sending Stats by DateTool to retrieve email sending statistics aggregated by date.
Get Sending Stats by DomainsTool to retrieve sending statistics grouped by domains for a Mailtrap account.
Get Sending Stats by ESPTool to retrieve email sending statistics grouped by email service providers (ESPs) for a specified date range.
Import ContactsTool to import contacts in bulk to Mailtrap.
List AccountsTool to list all Mailtrap accounts you have access to.
List Contact FieldsTool to get all contact fields for a Mailtrap account.
List Contact ListsTool to retrieve all contact lists for a Mailtrap account.
List Email TemplatesTool to retrieve all email templates for a Mailtrap account.
List InboxesTool to get a list of inboxes for a Mailtrap account.
List Messages in InboxTool to get messages from a Mailtrap inbox.
List ProjectsTool to get a list of projects for a Mailtrap account.
List Sending DomainsTool to list all sending domains for a Mailtrap account.
List Email SuppressionsTool to list suppressed email addresses for a Mailtrap account.
Mark Inbox as ReadTool to mark all messages in a Mailtrap inbox as read.
Reset Inbox CredentialsTool to reset SMTP credentials for a Mailtrap inbox.
Update contactTool to update an existing contact in Mailtrap.
Update Contact FieldTool to update a contact field in Mailtrap.
Update Contact ListTool to update a contact list's name in Mailtrap.
Update Email TemplateTool to update an existing email template in Mailtrap account.
Update inboxTool to update an inbox's settings in Mailtrap.
Update projectTool to update a project's name in Mailtrap.

Way Forward

Now that Mailtrap is connected, extend your setup by connecting the other apps you already use every day, so your agent can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.
  • Connect HubSpot or Salesforce to log customer context, update records, and draft follow-ups.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single MCP endpoint, your agent can coordinate multiple tools safely and reliably in one conversation.

How to build Mailtrap MCP Agent with another framework

FAQ

What are the differences in Tool Router MCP and Mailtrap MCP?

With a standalone Mailtrap MCP server, the agents and LLMs can only access a fixed set of Mailtrap tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Mailtrap and many other apps based on the task at hand, all through a single MCP endpoint.

Can I use Tool Router MCP with VS Code?

Yes, you can. VS Code fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Mailtrap tools.

Can I manage the permissions and scopes for Mailtrap while using Tool Router?

Yes, absolutely. You can configure which Mailtrap scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Mailtrap data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.