X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Postmark to Claude

Connect Claude Web, Desktop and Cowork to Postmark MCP. Send a password reset email to user, get delivery status for last 10 emails, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Postmark logoPostmark
Api Key

Postmark is an email delivery service for sending transactional emails with reliable deliverability. It delivers detailed analytics and fast, secure email delivery for developers.

46 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Postmark account to Claude via Composio Connect, enabling it to send a password reset email to user, get delivery status for last 10 emails, list all bounced emails from today, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Postmark with

OpenAI Agents SDKClaude Agent SDKClaude CodeCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Postmark to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Postmark account

Back in Claude, ask it to connect to Postmark or give it any Postmark-related task.

For example, ask Claude to:

  • "Send a password reset email to user"
  • "Get delivery status for last 10 emails"
  • "List all bounced emails from today"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Postmark account is ready to use.

What is the Postmark Claude Connector, and what's possible with it?

The Postmark MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Postmark account. It provides structured and secure access to transactional email sending and analytics, so your agent can perform actions like delivering transactional emails, monitoring delivery status, managing templates, and analyzing engagement metrics on your behalf.

  • Automated transactional email delivery: Let your agent send password resets, confirmations, and notification emails with high deliverability and reliability.
  • Template management and customization: Enable your agent to create, update, or select dynamic email templates for consistent, branded communications.
  • Email delivery status monitoring: Ask your agent to track sent messages, check delivery receipts, and identify bounced or failed emails in real time.
  • Engagement and analytics tracking: Have your agent retrieve open and click data, analyze engagement trends, and provide actionable insights from your email campaigns.
  • Suppression list and recipient management: Direct your agent to manage suppression lists, process unsubscribes, and maintain healthy recipient lists automatically.

Troubleshooting

1. Why does Claude not use the Composio connector for Postmark?

The connector can show as connected, but Claude must use it in each Postmark conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Postmark again.

2. Why does Claude show an MCP server error before Postmark connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Postmark.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Postmark.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Postmark authorization link not work?

The Composio connector is one server. Your Postmark account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Postmark connection.
  • Composio creates a fresh Postmark authorization link.
  • Open that link in your browser and finish the Postmark sign-in.

4. Why do Postmark actions fail after they worked before?

The Postmark connection can expire or lose permission.

  • Ask Claude to inspect the Postmark connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Postmark account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Postmark.
  • If the action still fails with a permission error, check that the connected account has that permission in Postmark itself.

5. How do I switch to a different Postmark account?

Claude can manage the Postmark connection for you.

  • Ask Claude to disconnect or delete the current Postmark account.
  • Ask Claude to connect Postmark again.
  • Open the new Composio authorization link for Postmark.
  • Sign in with the other Postmark account in the browser.
  • After the account connects, ask Claude to retry the Postmark task.

6. Why is my Postmark connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Postmark connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Postmark tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Postmark.
TOOLS

Supported Tools

Every Postmark action and event your agent gets out of the box.

Archive Message Stream

Tool to archive a message stream (soft delete).

Check Spam Score

Tool to assess the spam score of a raw email via the SpamCheck API.

Create Inbound Rule

Tool to create a new inbound rule trigger to block email from a specific sender or domain.

Create Message Stream

Tool to create a new message stream.

Create Suppressions

Tool to add email addresses to the suppression list for a message stream.

Create Template

Tool to create a new email template.

Create Webhook

Tool to create a new webhook configuration for Postmark.

Delete Inbound Rule

Tool to delete a specific inbound rule trigger.

Delete Suppressions

Tool to remove email addresses from the suppression list for a message stream.

Delete Template

Tool to delete a template by its ID or alias.

Delete Webhook

Tool to delete a specific webhook.

Edit Server

Tool to update settings for the current Postmark server.

Edit Template

Tool to update an existing Postmark template by its ID.

Edit Webhook

Tool to update an existing webhook’s URL or triggers.

Get Bounce Counts

Tool to get total counts of emails that have been returned as bounced.

Get Bounces

Tool to retrieve a list of bounces for a server with optional filters.

Get Browser Platform Usage

Tool to retrieve browser platform usage statistics for clicked links.

Get Browser Usage

Tool to retrieve browser usage statistics for clicked links.

Get Click Counts

Tool to retrieve total click counts across all links in emails.

Get Clicks By Browser Family

Tool to retrieve click statistics grouped by browser family.

Get Clicks by Location

Tool to get an overview of which part of the email links were clicked from (HTML or Text).

Get Delivery Stats

Tool to retrieve delivery statistics.

Get Email Client Usage

Tool to retrieve statistics on email clients used to open emails.

Get Email Open Counts

Tool to retrieve counts of opened emails.

Get Message Stream

Tool to retrieve details of a specific message stream by its ID.

Get Opens by Platform

Tool to retrieve email open statistics by platform type.

Get Outbound Overview

Tool to retrieve outbound email statistics overview.

Get Sent Counts

Tool to retrieve total count of emails sent out.

Get Server

Tool to retrieve details of the current Postmark server.

Get Spam Complaints

Tool to retrieve counts of spam complaints.

Get Template

Tool to retrieve details of a specific template by its ID.

Get Tracked Email Counts

Tool to retrieve counts of emails with tracking enabled.

Get Webhook

Tool to retrieve details of a specific webhook by its ID.

List Inbound Rules

Tool to list all inbound rules (triggers) configured for blocking senders.

List Message Streams

Tool to list all message streams for a Postmark server with optional type and archive filtering.

List Outbound Message Clicks

Tool to list clicks for outbound messages with filtering options.

List Outbound Message Opens

Tool to retrieve opens for outbound messages with filtering options.

List Suppressions

Tool to retrieve the suppression list for a message stream with optional filtering.

List Templates

Tool to list all templates for a Postmark server.

List Webhooks

Tool to list all webhooks configured for your Postmark account.

Search Inbound Messages

Tool to search inbound messages received with optional filtering.

Search Outbound Messages

Tool to search outbound messages with filtering by recipient, tag, status, and date range.

Send Batch Templated Emails

Tool to send multiple templated emails in a single batch API call.

Unarchive Message Stream

Tool to unarchive a previously archived message stream.

Update Message Stream

Tool to update a message stream configuration in Postmark.

Validate Template

Tool to validate a Postmark template.

FRAMEWORKS

How to build Postmark MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Postmark MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Postmark MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Postmark MCP with Claude Code

Codex logo

Codex

Use Postmark MCP with Codex

OpenClaw logo

OpenClaw

Use Postmark MCP with OpenClaw

Hermes logo

Hermes

Use Postmark MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Postmark MCP with Atomic Agent

Google ADK logo

Google ADK

Use Postmark MCP with Google ADK

LangChain logo

LangChain

Use Postmark MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Postmark MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Postmark MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Postmark MCP with LlamaIndex

CrewAI logo

CrewAI

Use Postmark MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Postmark MCP with Pydantic AI

AutoGen logo

AutoGen

Use Postmark MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Postmark MCP server, the agents and LLMs can only access a fixed set of Postmark tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Postmark and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Postmark tools.

Yes, absolutely. You can configure which Postmark scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Postmark data and credentials are handled as safely as possible.

Start with Postmark.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Postmark tool your agent needs.Free to start.

Start building