A
security-
licenseA
qualityA 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 -
6
410
Provides an MCP server implementation for sending emails via Postmark, offering tools for email management, template management, and delivery statistics tracking.
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
Clone the repository:
git clone https://github.com/ActiveCampaign/postmark-mcp cd postmark-mcpInstall dependencies:
npm installConfigure environment variables:
Copy
.env.exampleto.env:cp .env.example .envEdit
.envand 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
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:
Set your
POSTMARK_SERVER_TOKENin the MCP configurationSet your
DEFAULT_SENDER_EMAILin the MCP configurationSet your
DEFAULT_MESSAGE_STREAMin 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: trueTrackLinks: "HtmlAndText"Message stream from
DEFAULT_MESSAGE_STREAMenvironment 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 (
infofor normal operations,errorfor 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
Related Resources
Related MCP Servers
- -security-license-qualityMCP 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 -60GPL 3.0
- -security-license-qualityAn 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 -2MIT License
MailPace MCP Serverofficial
Asecurity-licenseAqualityAn MCP server implementation that allows sending emails over MailPace's fast transactional email API.Last updated -11MIT License