Postals MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 61 installs a week from npm. Last commit 16 Apr 2026.
Send physical handwritten postcards from any AI agent. Real pen & ink, USPS, $4.99/card.
Nothing serious here today
Today is the operative word: we check Postals MCP every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add postals-mcp -e 'POSTALS_API_KEY=<POSTALS_API_KEY>' -- npx -y postals-mcp{
"mcpServers": {
"postals-mcp": {
"command": "npx",
"args": [
"-y",
"postals-mcp"
],
"env": {
"POSTALS_API_KEY": "<POSTALS_API_KEY>"
}
}
}
}[mcp_servers.postals-mcp]
command = "npx"
args = ["-y", "postals-mcp"]
env = { POSTALS_API_KEY = "<POSTALS_API_KEY>" }{
"mcpServers": {
"postals-mcp": {
"command": "npx",
"args": [
"-y",
"postals-mcp"
],
"env": {
"POSTALS_API_KEY": "<POSTALS_API_KEY>"
}
}
}
}{
"servers": {
"postals-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"postals-mcp"
],
"env": {
"POSTALS_API_KEY": "<POSTALS_API_KEY>"
}
}
}
}Put your own value in place of
<POSTALS_API_KEY> (Your Handwrytten API key (v1.0) or Postals API key (v1.1+)).
The author’s registry entry marks it as required.
Optional settings from the registry entry, left out of the block above:
POSTALS_SENDER_NAME (Default sender full name for return address), POSTALS_SENDER_ADDRESS (Default sender street address), POSTALS_SENDER_CITY (Default sender city), POSTALS_SENDER_STATE (Default sender 2-letter US state code), POSTALS_SENDER_ZIP (Default sender 5-digit ZIP (or 5+4 format)), POSTALS_DEFAULT_CARD_IMAGE (Default card front image URL (HTTPS, PNG or JPEG, landscape 7x5 preferred)), POSTALS_HANDWRITING_STYLE (Default handwriting font. Default: Joyful Jennifer), POSTALS_DAILY_LIMIT (Max cards per day (safety net). Default: 50), POSTALS_TEST_MODE (Set to 'true' for test mode (validates inputs, no cards actually sent)), CLOUDFLARE_ACCOUNT_ID (Optional. Enables AI message generation via Cloudflare Workers AI), CLOUDFLARE_API_TOKEN (Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation).
Alternatives to Postals MCP
same job, measured the same waySend real handwritten postcards, written by robot pen and mailed in envelopes. Poland only.
Send real handwritten postcards, letters, notecards and gift cards, and track QR scan results.
Mail real US letters, postcards and certified mail from an agent, quoted before sending.
Send real handwritten cards in the US. A machine writes each one in ink, then we mail it.
Send USPS letters & certified mail from any agent. Hosted: sign in, no install.
Write, preview and mail real letters and postcards to US addresses from your AI app.
A physical postal address in Germany for AI agents. A human opens, scans and forwards your mail.
Send personalized physical gifts and letters to business contacts from AI agents
Postals MCP — questions
Answers built from our own checks of this server.