Postmark
Postmark MCP Server

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.

JSONCode
{ "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" } } } }

Where the settings live:

ClientSettings file
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json
Cursor.cursor/mcp.json in your project
Windsurf and othersThe MCP settings in the app. Paste the same block.

2. Fill in your details

SettingWhat to put there
POSTMARK_SERVER_TOKENYour Postmark server token (required)
DEFAULT_SENDER_EMAILThe verified address emails are sent from (required)
DEFAULT_MESSAGE_STREAMThe 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.

TerminalCode
git clone https://github.com/ActiveCampaign/postmark-mcp cd postmark-mcp npm install cp .env.example .env # then add your token and sender address npm start

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-mcp didn't actually work. The README already documented this as the recommended, primary way to run the server, but the package was missing the bin entry and executable shebang needed for npx/global installs to resolve a command. index.js now starts with #!/usr/bin/env node and package.json declares "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

  • prepublishOnly script (npm test). Runs the unit test suite automatically before npm 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)

  • getWebhook and editWebhook tools
  • createWebhook: postFirstOpenOnly, bounceIncludeContent, and spamIncludeContent parameters
  • 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