Postmark MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Postmark MCP or direct API to send transactional emails, fetch delivery analytics, manage message streams, and troubleshoot deliverability—all through natural language.
Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Postmark Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Try Postmark now

Enter a prompt below to test the integration in our Tool Router playground. You'll be redirected to sign in and try it live.

Supported Tools

Tools
Archive Message StreamTool to archive a message stream (soft delete).
Check Spam ScoreTool to assess the spam score of a raw email via the SpamCheck API.
Create Inbound RuleTool to create a new inbound rule trigger to block email from a specific sender or domain.
Create Message StreamTool to create a new message stream.
Create SuppressionsTool to add email addresses to the suppression list for a message stream.
Create TemplateTool to create a new email template.
Create WebhookTool to create a new webhook configuration for Postmark.
Delete Inbound RuleTool to delete a specific inbound rule trigger.
Delete SuppressionsTool to remove email addresses from the suppression list for a message stream.
Delete TemplateTool to delete a template by its ID or alias.
Delete WebhookTool to delete a specific webhook.
Edit ServerTool to update settings for the current Postmark server.
Edit TemplateTool to update an existing Postmark template by its ID.
Edit WebhookTool to update an existing webhook’s URL or triggers.
Get Bounce CountsTool to get total counts of emails that have been returned as bounced.
Get BouncesTool to retrieve a list of bounces for a server with optional filters.
Get Browser Platform UsageTool to retrieve browser platform usage statistics for clicked links.
Get Browser UsageTool to retrieve browser usage statistics for clicked links.
Get Click CountsTool to retrieve total click counts across all links in emails.
Get Clicks By Browser FamilyTool to retrieve click statistics grouped by browser family.
Get Clicks by LocationTool to get an overview of which part of the email links were clicked from (HTML or Text).
Get Delivery StatsTool to retrieve delivery statistics.
Get Email Client UsageTool to retrieve statistics on email clients used to open emails.
Get Email Open CountsTool to retrieve counts of opened emails.
Get Message StreamTool to retrieve details of a specific message stream by its ID.
Get Opens by PlatformTool to retrieve email open statistics by platform type.
Get Outbound OverviewTool to retrieve outbound email statistics overview.
Get Sent CountsTool to retrieve total count of emails sent out.
Get ServerTool to retrieve details of the current Postmark server.
Get Spam ComplaintsTool to retrieve counts of spam complaints.
Get TemplateTool to retrieve details of a specific template by its ID.
Get Tracked Email CountsTool to retrieve counts of emails with tracking enabled.
Get WebhookTool to retrieve details of a specific webhook by its ID.
List Inbound RulesTool to list all inbound rules (triggers) configured for blocking senders.
List Message StreamsTool to list all message streams for a Postmark server with optional type and archive filtering.
List Outbound Message ClicksTool to list clicks for outbound messages with filtering options.
List Outbound Message OpensTool to retrieve opens for outbound messages with filtering options.
List SuppressionsTool to retrieve the suppression list for a message stream with optional filtering.
List TemplatesTool to list all templates for a Postmark server.
List WebhooksTool to list all webhooks configured for your Postmark account.
Search Inbound MessagesTool to search inbound messages received with optional filtering.
Search Outbound MessagesTool to search outbound messages with filtering by recipient, tag, status, and date range.
Send Batch Templated EmailsTool to send multiple templated emails in a single batch API call.
Unarchive Message StreamTool to unarchive a previously archived message stream.
Update Message StreamTool to update a message stream configuration in Postmark.
Validate TemplateTool to validate a Postmark template.
Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Postmark tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Send a password reset email to user@example.com using the default template')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Why Use Composio?

AI Native Postmark Integration

  • Supports both Postmark MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for sending, tracking, and querying your Postmark email activity

Managed Auth

  • Built-in API key management with secure storage
  • Central place to manage, scope, and revoke Postmark access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Postmark
  • Scoped, least privilege access to Postmark resources
  • Full audit trail of agent actions to support review and compliance

Use Postmark with any AI Agent Framework

Choose a Framework you want to connect Postmark with

Frequently Asked Questions

Do I need my own developer credentials to use Postmark with Composio?

Yes, Postmark requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗