Skip to main content
Glama

Postmark MCP Server

by ActiveCampaign
npmGitHub
JavaScript
MIT License
928
25
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

Feedback

We'd love to hear from you! Please share your feedback and suggestions through our feedback form.

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": "node", "args": ["path/to/postmark-mcp/index.js"], "env": { "POSTMARK_SERVER_TOKEN": "your-postmark-server-token", "DEFAULT_SENDER_EMAIL": "your-sender-email@example.com", "DEFAULT_MESSAGE_STREAM": "your-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

1. sendEmail

Sends a single text email.

Example Prompt:

Send an email using Postmark to recipient@example.com 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).""

Expected Payload:

{ "to": "recipient@example.com", "subject": "Meeting Reminder", "textBody": "Don't forget our team meeting tomorrow at 2 PM. Please bring your quarterly statistics report (and maybe some snacks).", "htmlBody": "HTML version of the email body", // Optional "from": "sender@example.com", // Optional, uses DEFAULT_SENDER_EMAIL if not provided "tag": "meetings" // Optional }

Response Format:

Email sent successfully! MessageID: message-id-here To: recipient@example.com Subject: Meeting Reminder

2. sendEmailWithTemplate

Sends an email using a pre-defined template.

Example Prompt:

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

Expected Payload:

{ "to": "customer@example.com", "templateId": 12345, // Either templateId or templateAlias must be provided, but not both "templateAlias": "welcome", // Either templateId or templateAlias must be provided, but not both "templateModel": { "name": "John Doe", "product_name": "MyApp", "login_url": "https://myapp.com/login" }, "from": "sender@example.com", // Optional, uses DEFAULT_SENDER_EMAIL if not provided "tag": "onboarding" // Optional }

Response Format:

Template email sent successfully! MessageID: message-id-here To: recipient@example.com Template: template-id-or-alias-here

Template Management Tools

3. listTemplates

Lists all available templates.

Example Prompt:

Show me a list of all the email templates available in our Postmark account.

Response Format:

📋 Found 2 templates: • Basic - ID: 12345678 - Alias: basic - Subject: none • Welcome - ID: 02345679 - Alias: welcome - Subject: none

Statistics & Tracking Tools

4. getDeliveryStats

Retrieves email delivery statistics.

Example Prompt:

Show me our Postmark email delivery statistics from 2025-05-01 to 2025-05-15 for the "marketing" tag.

Expected Payload:

{ "tag": "marketing", // Optional "fromDate": "2025-05-01", // Optional, YYYY-MM-DD format "toDate": "2025-05-15" // Optional, YYYY-MM-DD format }

Response Format:

Email Statistics Summary Sent: 100 emails Open Rate: 45.5% (45/99 tracked emails) Click Rate: 15.2% (15/99 tracked links) Period: 2025-05-01 to 2025-05-15 Tag: marketing

Implementation Details

Automatic Configuration

All emails are automatically configured with:

  • TrackOpens: true

  • TrackLinks: "HtmlAndText"

  • Message stream from DEFAULT_MESSAGE_STREAM environment variable

Error Handling

The server implements comprehensive error handling:

  • Validation of all required environment variables

  • Graceful shutdown on SIGTERM and SIGINT

  • Proper error handling for API calls

  • No exposure of sensitive information in logs

  • Consistent error message formatting

Logging

  • Uses appropriate log levels (info for normal operations, error for errors)

  • Excludes sensitive information from logs

  • Provides clear operation status and results

For more information about the Postmark API, visit

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server implementation that enables sending emails via Postmark email services with features for sending plain text/HTML emails, using templates, tracking delivery statistics, and listing available templates.

  1. Features
    1. Feedback
      1. Requirements
        1. Setup
          1. Quick Install via Cursor Deeplink
            1. Claude and Cursor MCP Configuration Example
              1. Tool Reference
                1. Table of Contents
              2. Email Management Tools
                1. 1. sendEmail
                2. 2. sendEmailWithTemplate
              3. Template Management Tools
                1. 3. listTemplates
              4. Statistics & Tracking Tools
                1. 4. getDeliveryStats
              5. Implementation Details
                1. Automatic Configuration
                2. Error Handling
                3. Logging

              Related MCP Servers

              • Email Sending MCP

                resend
                A
                security
                F
                license
                A
                quality
                A simple MCP server that enables users to send emails using Resend's API, integrating with tools like Cursor and Claude Desktop for seamless email composition and delivery.
                Last updated -
                3
                396
                • Apple

              • Gmail MCP Server

                jasonsum
                -
                security
                A
                license
                -
                quality
                MCP server that integrates with Gmail to enable sending, reading, and managing emails through tools like send-email, trash-email, get-unread-emails, and read-email.
                Last updated -
                59
                GPL 3.0
                • Apple

              • AWS SES MCP

                omd01
                -
                security
                A
                license
                -
                quality
                An MCP server that enables sending emails directly through AWS SES without copy-pasting, supporting plain text and HTML emails with features like CC, BCC, and reply-to functionality.
                Last updated -
                2
                MIT License
                • Linux
                • Apple

              • MailPace MCP Serverofficial

                mailpace
                A
                security
                A
                license
                A
                quality
                An MCP server implementation that allows sending emails over MailPace's fast transactional email API.
                Last updated -
                1
                1
                MIT License

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/ActiveCampaign/postmark-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server