Postmark MCP Server
Connect your AI agents to Postmark
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.
Connect in three steps
You'll connect your AI assistant to Postmark by adding one block of settings to it. It takes a few minutes, and there's nothing to install by hand.
Before you start
- A Postmark server token. In Postmark, open your server, then API Tokens, and copy the Server API token.
- A verified sender address. Use a sender signature or domain you've already verified in Postmark.
- Node.js 22 or newer. Your AI tool uses it to run the server. Use the latest patch release of your version.
- An MCP client. Claude Desktop, Cursor, Windsurf, or any other tool that accepts the standard MCP settings.
Make sure you're installing the official server: github.com/ActiveCampaign/postmark-mcp.
1. Add the Postmark server to your client
Open your client's MCP settings and add this. It's the same block for every client.
Code
Where the settings live:
| Client | Settings file |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | .cursor/mcp.json in your project |
| Windsurf and others | The MCP settings in the app. Paste the same block. |
2. Fill in your details
| Setting | What to put there |
|---|---|
POSTMARK_SERVER_TOKEN | Your Postmark server token (required) |
DEFAULT_SENDER_EMAIL | The verified address emails are sent from (required) |
DEFAULT_MESSAGE_STREAM | The message stream to send through, usually outbound (required) |
Two optional settings can help: WEBHOOK_URL_ALLOWLIST limits which HTTPS addresses can be used for webhooks, and LOG_EMAIL_FULL (set to true) shows full email addresses in logs instead of masking them.
3. Restart your client and try it
Restart your AI tool so it picks up the new settings. Then ask it something like:
- "Send an email to joe@example.com, tell them their order has shipped"
- "Show me yesterday's email performance"
- "Send a welcome email to new customers"
Each tool in the sidebar shows an example you can try.
Keep it safe
- Use a dedicated Postmark server. The MCP server can do everything its token can do, and server tokens can't be limited to certain actions. A separate server with only the streams and senders you need keeps the risk small. Rotate the token if it's ever exposed.
- Approve sending and deleting yourself. Don't turn on auto-approval for tools that send email or delete things, especially in places you don't fully trust. Content in an email could try to trick an AI tool into calling them.
Run it from a local copy (optional)
If you'd rather not use npx, you can run the server from a local copy. Node.js 22 or newer is required.
Code
In your client's settings, use "command": "node" and "args": ["/absolute/path/to/postmark-mcp/index.js"] with the same env block as above.
Source: github.com/ActiveCampaign/postmark-mcp ยท npm: @activecampaign/postmark-mcp
Latest Release
Version: v2.1.1 โข Published: July 13, 2026
Changelog
What's New
Fixed
npx @activecampaign/postmark-mcpdidn't actually work. The README already documented this as the recommended, primary way to run the server, but the package was missing thebinentry and executable shebang needed fornpx/global installs to resolve a command.index.jsnow starts with#!/usr/bin/env nodeandpackage.jsondeclares"bin": { "postmark-mcp": "index.js" }.- README MIT license badge pointed at the wrong package. It resolved
@modelcontextprotocol/sdk's license instead of this package's. Now points at@activecampaign/postmark-mcp.
Changed
prepublishOnlyscript (npm test). Runs the unit test suite automatically beforenpm publish, so a broken build can't be published by accident. Maintainer-facing only; no effect on consumers.
What's Next (deferred to a future release)
getWebhookandeditWebhooktoolscreateWebhook:postFirstOpenOnly,bounceIncludeContent, andspamIncludeContentparameters- CI test gating on pull requests
- Async log writes for improved performance under burst load
Full Changelog: https://github.com/ActiveCampaign/postmark-mcp/blob/main/CHANGELOG.md
What You Can Do
This MCP server provides 24 tools organized into 8 categories:
- ๐ง Send emails - Single emails, batch sending, with or without templates
- ๐ Manage templates - Create, edit, delete, and validate email templates
- ๐ Track messages - Search sent messages and get detailed delivery info
- ๐ฉบ Diagnose issues - Troubleshoot delivery problems
- โ ๏ธ Handle bounces - Search bounces, view dumps, reactivate addresses
- ๐ซ Manage suppressions - Control your suppression list
- ๐ View statistics - Delivery stats and server configuration
- ๐ Configure webhooks - Set up event notifications