Postmark Integration

Pro v1.0.0

Send transactional emails and manage email templates via Postmark's email delivery platform

Requires Claude Code CLI

This skill integrates with Postmark through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Send Single Email

Send a single transactional email with HTML and text content

Parameters

Name Type Required Description
from string Required Sender email address (must be verified)
to string Required Recipient email address
subject string Required Email subject line
html string Optional HTML email body
text string Optional Plain text email body
cc string Optional CC email addresses
bcc string Optional BCC email addresses

Try saying...

  • "Send an email to user@example.com with subject 'Welcome'"
  • "Send a password reset email to john@example.com"
  • "Email the invoice to customer@company.com with CC to sales@mycompany.com"

Send Templated Email

Send an email using a pre-defined template with dynamic variables

Parameters

Name Type Required Description
alias string Required Template alias or ID
from string Required Sender email address
to string Required Recipient email address
model object Required JSON object with template variables

Try saying...

  • "Send welcome email template to user@example.com with name 'John'"
  • "Send password reset template with reset link"
  • "Send invoice template to customer with order details"

Pull Templates

Download all email templates from Postmark to local files for version control

Parameters

Name Type Required Description
overwrite boolean Optional Overwrite local files if they exist

Try saying...

  • "Download all email templates from Postmark"
  • "Pull latest templates from Postmark"
  • "Sync templates to local files"

Push Templates

Upload local template files to Postmark (only modified or new templates)

Try saying...

  • "Upload modified templates to Postmark"
  • "Push template changes to production"
  • "Deploy updated email templates"

Preview Templates

Start local web server to preview email templates

Returns

string Local server URL (http://localhost:3005)

Try saying...

  • "Preview email templates locally"
  • "Test templates before deploying"
  • "View rendered email templates"

List Servers

Display all Postmark servers in your account

Returns

array List of server names and IDs

Try saying...

  • "Show all my Postmark servers"
  • "List available email servers"
  • "What servers do I have in Postmark?"

Getting Started

CLI Authentication Easy Setup
  1. 1 Log in to your Postmark account at https://account.postmarkapp.com
  2. 2 Navigate to your Server > API Tokens tab
  3. 3 Copy your Server Token
  4. 4 Add to shell config: echo 'export POSTMARK_SERVER_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
  5. 5 Restart terminal or run: source ~/.zshrc
  6. 6 (Optional) For account-level operations, get Account Token from Account Settings > API Tokens

Verify Setup

postmark servers list

Success: Displays list of your Postmark servers

View full setup guide

Security & Access

Access Scope

Server tokens can send emails, access message history, and manage templates for that specific server. Account tokens have full account access including creating/deleting servers and managing domains.

  • Server tokens allow sending emails from your verified domains - keep them secure
  • Account tokens have full account access - use with extreme caution
  • Never commit tokens to version control or share them publicly
  • Use separate servers for production and staging environments
  • Tokens are scoped per server for isolation - one compromised token doesn't affect other servers

Limitations

  • From address must be on a verified domain or confirmed Sender Signature
  • Batch emails limited to 500 messages per API call
  • Maximum 50 recipients per email (To, Cc, Bcc combined)
  • Templates must be created in Postmark dashboard before use
  • CLI requires Node.js and npm to be installed

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
CLI
Auth
CLI Authentication
Setup
Easy Setup
Tools Required
Bash
CLI Dependencies
postmark-cli

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements