Postmark Account MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Postmark Account MCP search outbound messages to jane@acme.com from last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
postmark-account-mcp
Read-only MCP server for Postmark that works across all servers of one or more Postmark accounts.
Auth with Account API tokens; each server's token is discovered automatically (
GET /servers).New servers / accounts appear without reconfiguration (5-min cache, accounts file re-read on refresh).
No send / create / update / delete operations exist — on purpose.
Tools
Every tool takes optional account and server (partial, case-insensitive; server also accepts a
numeric ID or account/server). Omit them to query everything.
Tool | What |
| All accounts → servers → message streams (tokens never returned) |
| Outbound search (recipient, sender, subject, tag, status, stream, dates) |
| Event timeline of one message (Delivered / Bounced / Opened / Clicked); finds its server automatically |
| Bounces (email, type, inactive, dates) |
| Suppressed recipients per stream |
| Sent / bounce rate / spam / opens / clicks |
Related MCP server: OpenArchiver MCP Server
Install (on any machine)
git clone https://github.com/ckaklamanos/postmark-account-mcp.git ~/Applications/postmark-account-mcp
cd ~/Applications/postmark-account-mcp && npm install
# accounts file — kept OUTSIDE the repo
mkdir -p ~/.config/postmark-account-mcp
cp accounts.example.json ~/.config/postmark-account-mcp/accounts.json
chmod 600 ~/.config/postmark-account-mcp/accounts.json
# edit it: { "account-name": "account-api-token", ... }
# register in Claude Code for ALL projects
claude mcp add --scope user postmark -- node ~/Applications/postmark-account-mcp/index.jsAccount API token: Postmark → Account → API Tokens (not a server token).
Configuration
Variable | Default |
|
|
| Fallback single account ( |
Accounts file format: { "name": "token", ... } (or { "accounts": { ... } }).
Update
cd ~/Applications/postmark-account-mcp && git pull && npm installThen restart Claude Code.
Requires Node 18+.
License
Available Tools
6 toolsdelivery_statsDelivery statsBRead-onlyIdempotent
Outbound overview per server: sent, bounced, bounce rate, spam complaints, opens, clicks.
Inputs: tag, server, stream, todate, +2 more.
get_message_detailsMessage delivery timelineBRead-onlyIdempotent
Full details + event timeline (Delivered, Bounced, Opened, Clicked, ...) of one outbound message. If server is omitted, all servers are tried.
Inputs: message_id (required), server, account, include_body.
list_serversList Postmark accounts & serversARead-onlyIdempotent
List all configured accounts and their servers (name, ID, message streams). Tokens are never returned. Re-reads the accounts file.
Inputs: account, include_streams.
list_suppressionsList suppressionsARead-onlyIdempotent
Suppressed recipients per server/stream (hard bounces, spam complaints, manual). Omit server for all servers; omit stream for all streams.
Inputs: email, server, stream, account.
search_bouncesSearch bouncesBRead-onlyIdempotent
Search bounces across all servers (or one).
Inputs: type, count, email, server, +4 more.
search_messagesSearch outbound messagesARead-onlyIdempotent
Search outbound messages across all servers (or one). Returns ID, status, recipients, subject, time. Use get_message_details for the delivery event timeline.
Inputs: tag, count, offset, server, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct concept: server inventory, message search, single-message drill-down, bounce search, suppression lists, and aggregate stats. The descriptions explicitly route between search_messages and get_message_details, though search_bounces vs list_suppressions could be momentarily confused since both relate to failed delivery and the distinction (events vs suppressed addresses) must be inferred.
Five of six tools follow a clean verb_noun snake_case pattern (list_servers, search_messages, get_message_details, search_bounces, list_suppressions). delivery_stats breaks the pattern as a bare noun phrase, a minor deviation that is still readable in context.
Six tools is well within the sweet spot for a focused read-only account/message observability server. Each tool covers a distinct facet (inventory, search, detail, bounces, suppressions, stats) with no filler.
The surface covers the core read workflows end-to-end: find servers, search and drill into messages, inspect bounces and suppressions, and roll up stats. Gaps exist but are minor for a read-only account server — no inbound message search, no way to fetch a single bounce or suppression record, and no suppression management (e.g. reactivating an address).
Maintenance
Related MCP Connectors
Ask about your email delivery: stats, bounces, complaints, message lookup and DNS health. Read-only.
Read-only access to a Lumin project's logs, metrics, uptime checks, alerts and infrastructure.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Read-only access to your Infrly services, deploys, logs, metrics and billing.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables read-only, provider-agnostic email access over IMAP, allowing users to list folders, search and read messages, and download attachments without ever marking messages as read.630 PyPIMIT
- AlicenseAqualityBmaintenanceProvides read-only search and retrieval of archived emails, archive statistics, health, and ingestion sources, with an optional administrative toolset for user, role, reindexing, and queue management.6MIT
- AlicenseNot gradedqualityCmaintenanceProvides read-only access to Proton Mail through the local Proton Bridge, enabling search, retrieval, and listing of messages, threads, folders, and attachments without any mutating capabilities.MIT
- AlicenseAqualityBmaintenanceEnables read-only access to Klaviyo marketing data, including campaigns, flows, segments, metrics, reports, and customer profiles, across multiple Klaviyo accounts.2434 npmMIT