Postlane MCP server
Commit Nov 6, 2026Allows AI agents to send transactional emails and monitor email activity through the Postlane API.
Also known as zwebso/postlane, postlane-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 6, 2026
- License
- —
What is Postlane MCP?
Postlane allows AI agents to send transactional emails and monitor email activity through the Postlane API.
Summary generated from the project's README
About Postlane MCP server
Sending transactional emails like welcome messages, password resets, and receipts directly through an AI agent is what this server enables. Developers using Cursor, Claude Code, Gemini CLI, or any standard MCP client can integrate email functionality into their coding workflows. The server provides specific tools including send_email, get_email, and list_emails to manage communication tasks.
To use these tools, you must provide a Postlane API key starting with pl_live_. Depending on your needs, you can use a send-only key to dispatch messages or a key with Read activity or Full access to monitor email activity. You must also ensure your from address belongs to a domain verified within your Postlane account. The server operates by sending your API key and email details to the Postlane API, but it stores no data locally on your machine.
What you can do with it
- 1Automate user onboarding emailsInstruct your agent to send a welcome email immediately after a new user signs up for your application.
- 2Implement password recovery flowsAsk the AI to set up a password reset email using a specific predefined template.
- 3Verify domain configuration requirementsQuery the agent to find out which DNS records are necessary to verify your sending domain.
- 4Monitor email activity historyUse the server to retrieve a list of sent emails or check the status of a specific message.
Written from the project's README. Every use case is checked against a quote from it.
How to install Postlane MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Postlane MCP in Claude Code
$ claude mcp add --env 'POSTLANE_API_KEY=<YOUR_POSTLANE_API_KEY>' postlane -- npx -y postlane-mcpInstall Postlane MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"postlane": {
"command": "npx",
"args": [
"-y",
"postlane-mcp"
],
"env": {
"POSTLANE_API_KEY": "<YOUR_POSTLANE_API_KEY>"
}
}
}
}Install Postlane MCP in VS Code
.vscode/mcp.json
{
"servers": {
"postlane": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"postlane-mcp"
],
"env": {
"POSTLANE_API_KEY": "<YOUR_POSTLANE_API_KEY>"
}
}
}
}Install Postlane MCP in VS Code CLI
$ code --add-mcp '{"name":"postlane","type":"stdio","command":"npx","args":["-y","postlane-mcp"],"env":{"POSTLANE_API_KEY":"<YOUR_POSTLANE_API_KEY>"}}'Install Postlane MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"postlane": {
"command": "npx",
"args": [
"-y",
"postlane-mcp"
],
"env": {
"POSTLANE_API_KEY": "<YOUR_POSTLANE_API_KEY>"
}
}
}
}Install Postlane MCP in Codex
$ codex mcp add postlane --env 'POSTLANE_API_KEY=<YOUR_POSTLANE_API_KEY>' -- npx -y postlane-mcpInstall Postlane MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.postlane] command = "npx" args = ["-y", "postlane-mcp"] [mcp_servers.postlane.env] POSTLANE_API_KEY = "<YOUR_POSTLANE_API_KEY>"
Install Postlane MCP in Gemini CLI
$ gemini mcp add -s user -e 'POSTLANE_API_KEY=<YOUR_POSTLANE_API_KEY>' postlane npx -- -y postlane-mcpInstall Postlane MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"postlane": {
"command": "npx",
"args": [
"-y",
"postlane-mcp"
],
"env": {
"POSTLANE_API_KEY": "<YOUR_POSTLANE_API_KEY>"
}
}
}
}Configuration
POSTLANE_API_KEYRequiredSecretBearer key from https://www.postlane.email/app/api-keys. It starts with pl_live_.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablezwebso/postlane is public and reachablegithub.com/zwebso/postlane ↗Pass
- Package names this repository as its sourcepostlane-mcp names zwebso/postlane as sourcenpmjs.com/package/postlane-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-06github.com/zwebso/postlane ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packagepostlane-mcp looks like @conorbronsdon/postlint-mcpFinding
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubPostlane for coding agents
This plugin tells coding agents to use Postlane for transactional email: welcome mail, password resets, receipts, and notifications. It works in Cursor, Claude Code, Gemini CLI, Codex, and any MCP client.
It has two parts:
- A skill that teaches
POST https://www.postlane.email/v1/emails - An MCP server with
send_email,get_email, andlist_emails
Every install needs a key the user creates at https://www.postlane.email/app/api-keys. It starts with pl_live_. Use a key with Read activity or Full access if you want list_emails. Send-only keys can send and can read one message by id. The from address must be on a domain verified at https://www.postlane.email/app/domains. Do not read a key that is already on the machine, and do not commit one.
Examples
- Send a welcome email when a user signs up, using Postlane.
- Add a password reset email with the Reset your password template.
- What DNS records do I need to verify my sending domain?
Cursor
- Install the plugin from Customize, or copy this folder to
~/.cursor/plugins/local/postlaneand reload Cursor. - Open Customize, select Postlane, and set Postlane API key.
Claude Code
claude plugin marketplace add zwebso/postlane
claude plugin install postlane@postlane
The Claude directory listing is the skill only. It does not start a program on the user's computer. Application code calls the HTTP API with a key the user creates.
Gemini CLI
gemini extensions install https://github.com/zwebso/postlane-plugin
Gemini CLI asks for the API key during install and keeps it in the system keychain.
Codex and ChatGPT
Install Postlane from the Plugins directory. That listing includes the skill only. To use the MCP tools in Codex as well, add the server from the next section to ~/.codex/config.toml.
Any MCP client (Cline, VS Code, Windsurf, Claude Desktop)
The user creates the key, then enters that new value in the client secret field. Do not copy a key from an existing environment variable.
{
"mcpServers": {
"postlane": {
"command": "npx",
"args": ["-y", "postlane-mcp@0.1.0"],
"env": { "POSTLANE_API_KEY": "<the key the user just created>" }
}
}
}
Privacy
The plugin stores nothing on your machine. When a Postlane tool runs, it sends your API key and the email you asked for (sender, recipients, subject, and body) to the Postlane API at https://www.postlane.email, and nowhere else. Postlane keeps send records while the workspace exists. See the Privacy Policy and Terms of Service.
Development
npm test runs the MCP server tests. Each agent reads its own manifest from this folder:
| Agent | Manifest |
|---|---|
| Cursor | .cursor-plugin/plugin.json and mcp.json |
| Claude Code | .claude-plugin/plugin.json and .claude-plugin/marketplace.json |
| Gemini CLI | gemini-extension.json |
| Codex and ChatGPT | .codex-plugin/plugin.json |
| MCP Registry and npm | server.json and package.json |
Keep version the same in all of them when you release.
Postlane MCP questions
How do I add Postlane MCP to Claude Code?
Run claude mcp add --env 'POSTLANE_API_KEY=<YOUR_POSTLANE_API_KEY>' postlane -- npx -y postlane-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Postlane MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What kind of emails can I send with Postlane?
You can use it for transactional emails such as welcome emails, password resets, receipts, and notifications.
How do I get an API key for Postlane?
You must create an API key at the Postlane website.
What are the requirements for the 'from' email address?
The sender address must belong to a domain that has been verified in your Postlane account.
Does the plugin store my data locally?
No, the plugin does not store any information on your machine; it only sends the API key and email details to the Postlane API.