communication

Postmark CLI for Headless Automation

Use the Postmark CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

9 functions 7 read 2 write API token auth

Submit Postmark feedback View package source

Postmark CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Postmark CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Postmark CLI for Headless Automation
kosmokrator integrations:configure postmark --set server_token="$POSTMARK_SERVER_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call postmark.postmark_list_messages '{"count":1,"offset":1,"recipient":"example_recipient","fromemail":"example_fromemail","subject":"example_subject","status":"example_status","tag":"example_tag"}' --json

Discovery Before Execution

Agents and scripts can inspect Postmark docs and schemas before choosing a function.

kosmo integrations:docs postmark --json
kosmo integrations:docs postmark.postmark_list_messages --json
kosmo integrations:schema postmark.postmark_list_messages --json
kosmo integrations:search "Postmark" --json
kosmo integrations:list --json

Useful Postmark CLI Functions

Function	Type	Parameters	Description
`postmark.postmark_list_messages`	Read	count, offset, recipient, fromemail, subject, status, tag	List outbound messages from Postmark. Supports filtering by recipient, sender, subject, status, and tag.
`postmark.postmark_get_message`	Read	message_id	Get details for a specific Postmark outbound message including body, recipients, and delivery status.
`postmark.postmark_send_email`	Write	To, From, Subject, TextBody, HtmlBody, Cc, Bcc, Tag, ReplyTo	Send an email through Postmark. Requires To, From, and Subject. Provide either TextBody or HtmlBody.
`postmark.postmark_send_template`	Write	From, To, TemplateId, TemplateAlias, TemplateModel, Cc, Bcc, ReplyTo, Tag, TrackOpens, TrackLinks	Send an email using a Postmark template. Provide either a TemplateId or TemplateAlias along with the template model data.
`postmark.postmark_get_delivery_stats`	Read	none	Get email delivery statistics for your Postmark server, including counts of sent, bounced, and spam complaints.
`postmark.postmark_list_templates`	Read	count, offset	List all email templates in Postmark. Supports pagination.
`postmark.postmark_get_template`	Read	template_id	Get details for a Postmark email template including subject, HTML body, and text body.
`postmark.postmark_list_servers`	Read	count, offset, name	List servers in the Postmark account. Supports filtering by name and pagination.
`postmark.postmark_get_current_user`	Read	none	Get the current Postmark server info including name, settings, and delivery stats. Useful as a health check.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Postmark CLI Pages

CI Postmark CLI for CI. Cron Jobs Postmark CLI for cron jobs. Shell Scripts Postmark CLI for shell scripts. Coding Agents Postmark CLI for coding agents.