Postmark MCP Server

An MCP server implementation for Postmark email services.

Features

• Exposes a Model Context Protocol (MCP) server for sending emails via Postmark
• Simple configuration via environment variables
• Comprehensive error handling and graceful shutdown
• Secure logging practices (no sensitive data exposure)
• Automatic email tracking configuration

Requirements

• Node.js (v16 or higher recommended)
• A Postmark account and server token

Setup

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. Configure environment variables:

   • Copy .env.example to .env:

     cp .env.example .env
     

   • Edit .env and fill in your Postmark credentials and settings.

   Variable	Description	Required
   POSTMARK_SERVER_TOKEN	Your Postmark server API token	Yes
   DEFAULT_SENDER_EMAIL	Default sender email address	Yes
   DEFAULT_MESSAGE_STREAM	Postmark message stream (e.g., ‘outbound’)	Yes

4. Run the server:

   npm start
   

Quick Install via Cursor Deeplink

You can quickly install this MCP server in Cursor by clicking the following button:

Note: After clicking the button, you’ll need to:

1. Set your POSTMARK_SERVER_TOKEN in the MCP configuration
2. Set your DEFAULT_SENDER_EMAIL in the MCP configuration
3. Set your DEFAULT_MESSAGE_STREAM in the MCP configuration (defaults to “outbound”)

Claude and Cursor MCP Configuration Example

{
  "mcpServers": {
    "Postmark": {
      "command": "your-node-path", // which node
      "args": ["/Users/your-name/your-location/postmark-mcp/index.js"], // realpath index.js
      "env": {
        "POSTMARK_SERVER_TOKEN": "your-postmark-server-token",
        "DEFAULT_SENDER_EMAIL": "your-default-sender-email",
        "DEFAULT_MESSAGE_STREAM": "your-default-message-stream"
      }
    }
  }
}

Tool Reference

This section provides a complete reference for the Postmark MCP server tools, including example prompts and expected payloads for each.

Table of Contents

• Email Management Tools
  • sendEmail
  • sendEmailWithTemplate