Now with 24 new tools
Connect Claude Desktop, Cursor, Windsurf, and other AI tools directly to your email infrastructure. The Postmark MCP server gives your AI assistant secure, conversational control over your emails, templates, deliverability stats, bounces, suppressions, and webhooks.
Note: Before using our MCP, please confirm you're using our official MCP server,
which can be found at https://github.com/ActiveCampaign/postmark-mcp
Prompt your AI assistant to handle tasks across all 24 tools in the Postmark MCP server.
Send plain text or HTML to one recipient or up to 50 at once. Add CC, BCC, and reply-to fields. Send via template alias or template ID. Batch up to 500 messages in a single API call.
Ask "Did my email reach this address, and if not, why?" The diagnoseDelivery tool searches message history, checks suppressions, and scans bounce history in parallel, then gives you a plain-English answer.
List, create, edit, delete, and validate templates (including layout binding) all through natural language. No template editor required.
Get open rates, click rates, bounce rates, spam rates, and platform/client breakdowns. Filter by tag or date range. Ask for a summary or drill into any specific stat.
Search bounces, retrieve the original bounce dump, reactivate addresses, and manage suppression lists — add or remove up to 50 addresses at a time.
List, create, and delete webhooks through conversation. HTTPS-only by default. Optionally set a URL allowlist so your AI assistant can only create webhooks pointing at approved endpoints.
No local clone required. Add this snippet to your MCP client config and you're sending.
1. Add to your MCP config (Cursor, Claude Desktop, or Windsurf)
{
"mcpServers": {
"postmark": {
"command": "npx",
"args": ["-y", "@activecampaign/postmark-mcp"],
"env": {
"POSTMARK_SERVER_TOKEN": "your-postmark-server-token",
"DEFAULT_SENDER_EMAIL": "your-sender@example.com",
"DEFAULT_MESSAGE_STREAM": "outbound"
}
}
}
}
2. Add your Postmark API token and sender address
Find your server token in your Postmark account under Servers → API Tokens.
3. Start prompting
Try: "Send an email using Postmark to recipient@example.com with the subject 'Meeting reminder' and the message 'Don't forget our team standup tomorrow at 2 PM.'"
Your Postmark API token stays in your local environment — it's never transmitted to Anthropic or any other AI provider. The MCP server communicates directly with Postmark's API over HTTPS.
a***e@example.com). Set LOG_EMAIL_FULL=true to disable masking if you need it.
Stop wrestling with APIs and custom integrations. Turn complex email tasks into simple conversations. With the Postmark MCP Server, you can prompt your AI assistant to "Send a welcome email to new customers" or "Show me yesterday's email performance" and get results in seconds.
Postmark's MCP Server lets AI tools like Claude Desktop, Cursor, and Windsurf securely access and manage your Postmark account through natural language commands. It connects 24 tools across eight categories — sending, templates, message search, diagnostics, bounces, suppressions, webhooks, and server info — so your AI assistant can handle your email infrastructure conversationally, with no coding required.
The quickest path requires no local clone. Add this code snippet to your MCP client config (Cursor, Claude Desktop, or Windsurf):
{ "mcpServers": { "postmark": { "command": "npx", "args": ["-y", "@activecampaign/postmark-mcp"], "env": { "POSTMARK_SERVER_TOKEN": "your-postmark-server-token", "DEFAULT_SENDER_EMAIL": "your-sender@example.com", "DEFAULT_MESSAGE_STREAM": "outbound" } } } }
Then add your Postmark server token (found in your account under Servers → API Tokens) and start prompting.
Prefer a local install? Clone the repo, run npm install, copy .env.example to .env, and run npm start. Full instructions are in the README on GitHub.
The MCP server works with any tool that supports the Model Context Protocol — including Claude Desktop, Cursor, Windsurf, and a growing ecosystem of AI development tools. The protocol is open-source and designed for extensibility. You can install the server with a single npx command, with no local clone required.
The MCP server is completely free and open-source (MIT licensed). You only need an active Postmark account for sending emails, which follows standard Postmark pricing.
The server is open source (MIT licensed) and designed for extensibility. You can fork the repo, add custom tools, or integrate it into your own AI workflows. A 52-test suite covers unit, offline MCP validation, and end-to-end scenarios — so you can contribute with confidence. Check the GitHub repository for contribution guidelines.
Your Postmark API token is stored locally and never transmitted to any AI provider — the MCP server communicates directly with Postmark's API over HTTPS. Email addresses in logs are masked by default (e.g., a***e@example.com) to reduce PII exposure. Webhook creation requires HTTPS URLs, and you can set a URL allowlist to restrict which endpoints the server will accept. All 24 tools carry read-only, destructive, and idempotency annotations, so MCP clients can surface risk indicators before taking action.
