Postals MCP Server
by coopergwrennio.github.coopergwrenn/postals-mcpv1.0.0
Send physical handwritten postcards from any AI agent. Real pen & ink, USPS, $4.99/card.
context tax
queued
security
queued
cold start
queued
freshness
Slowing6mo ago
Install Postals MCP server
Install in Claude Code
claude mcp add postals -e POSTALS_API_KEY='<postals-api-key>' -e CLOUDFLARE_API_TOKEN='<cloudflare-api-token>' -- npx -y postals-mcpInstall in Cursor
{
"mcpServers": {
"postals": {
"command": "npx",
"args": [
"-y",
"postals-mcp"
],
"env": {
"POSTALS_API_KEY": "<postals-api-key>",
"CLOUDFLARE_API_TOKEN": "<cloudflare-api-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"postals": {
"command": "npx",
"args": [
"-y",
"postals-mcp"
],
"env": {
"POSTALS_API_KEY": "<postals-api-key>",
"CLOUDFLARE_API_TOKEN": "<cloudflare-api-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"postals": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"postals-mcp"
],
"env": {
"POSTALS_API_KEY": "<postals-api-key>",
"CLOUDFLARE_API_TOKEN": "<cloudflare-api-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"postals": {
"command": "npx",
"args": [
"-y",
"postals-mcp"
],
"env": {
"POSTALS_API_KEY": "<postals-api-key>",
"CLOUDFLARE_API_TOKEN": "<cloudflare-api-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| POSTALS_API_KEY | yes | yes | Your Handwrytten API key (v1.0) or Postals API key (v1.1+). |
| 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 | — | yes | Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation. |
Freshness
Slowing — last maintenance signal 6mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-04-16 · 6mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-04-15 · 6mo ago · official registry · v1.0.0
FAQ
›How do I install the Postals MCP server in Claude Code?
Run: claude mcp add postals -e POSTALS_API_KEY='<postals-api-key>' -e CLOUDFLARE_API_TOKEN='<cloudflare-api-token>' -- npx -y postals-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Postals require an API key?
Yes. It expects POSTALS_API_KEY, CLOUDFLARE_API_TOKEN, of which 2 are secrets.
›Can I use Postals as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Postals in the official MCP registry?
Yes, as io.github.coopergwrenn/postals-mcp.