Postmark MCP

How to Install and Use Postmark MCP

Postmark MCP is a tool that helps you send emails using Postmark with AI assistants like Claude or Cursor. It makes email sending easy and secure. Here’s a simple guide to get you started with Postmark MCP.

Step 1: Make Sure You Have What You Need

Before installing, check that you have the right setup. You need:

• Node.js version 16 or higher on your computer.
• A Postmark account (you can sign up here).
• Your Postmark server token for sending emails.

Step 2: Download the Postmark MCP Code

To get started, you first need to copy the Postmark MCP code to your computer. Open your command line or terminal and run these commands:

git clone https://github.com/ActiveCampaign/postmark-mcp
cd postmark-mcp

This will download the code and move you to the right folder on your machine.

Step 3: Install the Necessary Packages

Once inside the folder, you need to install the software packages that Postmark MCP depends on. You can do this using one of the following commands:

npm install
# or
yarn
# or
bun install

Any of these commands will work, so use the one you prefer.

Step 4: Set Up Your Configuration

Postmark MCP uses environment variables to work properly. To configure it, create your own .env file from the example provided:

cp .env.example .env

Now, open the .env file in a text editor and add your Postmark details like this:

POSTMARK_SERVER_TOKEN=your-postmark-server-token
[email protected]
DEFAULT_MESSAGE_STREAM=outbound

Important: Never share or add this file to version control like GitHub, because it has secret information.

Step 5: Start the Postmark MCP Server

You are ready to start the Postmark MCP server and begin sending emails. Run this command in your terminal:

npm start
# or
yarn start
# or
bun start

The server will run and wait for email commands.

Step 6: Examples of Sending Emails

Here are two practical examples to use Postmark MCP for sending emails.

Sending a Simple Email

To send a basic email, you could write a request like this:

Send an email using Postmark to [email protected] with the subject "Meeting Reminder" and the message "Don't forget our team meeting tomorrow at 2 PM. Please bring your quarterly statistics report (and maybe some snacks)."

The data sent will look like:

{
  "to": "[email protected]",
  "subject": "Meeting Reminder",
  "textBody": "Don't forget our team meeting tomorrow at 2 PM. Please bring your quarterly statistics report (and maybe some snacks).",
  "from": "[email protected]"
}

Sending an Email with a Template

If you want to use a pre-made email template, you can ask like this:

Send an email with Postmark template alias "welcome" to [email protected] with the following template variables:
{
  "name": "John Doe",
  "product_name": "MyApp",
  "login_url": "https://myapp.com/login"
}

The data for this case will be:

{
  "to": "[email protected]",
  "templateAlias": "welcome",
  "templateModel": {
    "name": "John Doe",
    "product_name": "MyApp",
    "login_url": "https://myapp.com/login"
  },
  "from": "[email protected]"
}

Conclusion

By following these steps, you can easily install and use Postmark MCP on your computer. It makes managing emails simple and works well with AI tools. Just remember to keep your secret Postmark tokens safe and configure your .env file correctly. Happy emailing!