Postals Mcp

io.github.coopergwrenn/postals-mcp · v1.0.0

Send physical handwritten postcards from any AI agent. Real pen & ink, USPS, $4.99/card.

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add postals-mcp -e POSTALS_API_KEY=<POSTALS_API_KEY> -e POSTALS_SENDER_NAME=<POSTALS_SENDER_NAME> -e POSTALS_SENDER_ADDRESS=<POSTALS_SENDER_ADDRESS> -e POSTALS_SENDER_CITY=<POSTALS_SENDER_CITY> -e POSTALS_SENDER_STATE=<POSTALS_SENDER_STATE> -e POSTALS_SENDER_ZIP=<POSTALS_SENDER_ZIP> -e POSTALS_DEFAULT_CARD_IMAGE=<POSTALS_DEFAULT_CARD_IMAGE> -e POSTALS_HANDWRITING_STYLE=<POSTALS_HANDWRITING_STYLE> -e POSTALS_DAILY_LIMIT=<POSTALS_DAILY_LIMIT> -e POSTALS_TEST_MODE=<POSTALS_TEST_MODE> -e CLOUDFLARE_ACCOUNT_ID=<CLOUDFLARE_ACCOUNT_ID> -e CLOUDFLARE_API_TOKEN=<CLOUDFLARE_API_TOKEN> -- npx -y [email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "postals-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "POSTALS_API_KEY": "<POSTALS_API_KEY>",
        "POSTALS_SENDER_NAME": "<POSTALS_SENDER_NAME>",
        "POSTALS_SENDER_ADDRESS": "<POSTALS_SENDER_ADDRESS>",
        "POSTALS_SENDER_CITY": "<POSTALS_SENDER_CITY>",
        "POSTALS_SENDER_STATE": "<POSTALS_SENDER_STATE>",
        "POSTALS_SENDER_ZIP": "<POSTALS_SENDER_ZIP>",
        "POSTALS_DEFAULT_CARD_IMAGE": "<POSTALS_DEFAULT_CARD_IMAGE>",
        "POSTALS_HANDWRITING_STYLE": "<POSTALS_HANDWRITING_STYLE>",
        "POSTALS_DAILY_LIMIT": "<POSTALS_DAILY_LIMIT>",
        "POSTALS_TEST_MODE": "<POSTALS_TEST_MODE>",
        "CLOUDFLARE_ACCOUNT_ID": "<CLOUDFLARE_ACCOUNT_ID>",
        "CLOUDFLARE_API_TOKEN": "<CLOUDFLARE_API_TOKEN>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "postals-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "POSTALS_API_KEY": "<POSTALS_API_KEY>",
        "POSTALS_SENDER_NAME": "<POSTALS_SENDER_NAME>",
        "POSTALS_SENDER_ADDRESS": "<POSTALS_SENDER_ADDRESS>",
        "POSTALS_SENDER_CITY": "<POSTALS_SENDER_CITY>",
        "POSTALS_SENDER_STATE": "<POSTALS_SENDER_STATE>",
        "POSTALS_SENDER_ZIP": "<POSTALS_SENDER_ZIP>",
        "POSTALS_DEFAULT_CARD_IMAGE": "<POSTALS_DEFAULT_CARD_IMAGE>",
        "POSTALS_HANDWRITING_STYLE": "<POSTALS_HANDWRITING_STYLE>",
        "POSTALS_DAILY_LIMIT": "<POSTALS_DAILY_LIMIT>",
        "POSTALS_TEST_MODE": "<POSTALS_TEST_MODE>",
        "CLOUDFLARE_ACCOUNT_ID": "<CLOUDFLARE_ACCOUNT_ID>",
        "CLOUDFLARE_API_TOKEN": "<CLOUDFLARE_API_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "postals-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "POSTALS_API_KEY": "<POSTALS_API_KEY>",
        "POSTALS_SENDER_NAME": "<POSTALS_SENDER_NAME>",
        "POSTALS_SENDER_ADDRESS": "<POSTALS_SENDER_ADDRESS>",
        "POSTALS_SENDER_CITY": "<POSTALS_SENDER_CITY>",
        "POSTALS_SENDER_STATE": "<POSTALS_SENDER_STATE>",
        "POSTALS_SENDER_ZIP": "<POSTALS_SENDER_ZIP>",
        "POSTALS_DEFAULT_CARD_IMAGE": "<POSTALS_DEFAULT_CARD_IMAGE>",
        "POSTALS_HANDWRITING_STYLE": "<POSTALS_HANDWRITING_STYLE>",
        "POSTALS_DAILY_LIMIT": "<POSTALS_DAILY_LIMIT>",
        "POSTALS_TEST_MODE": "<POSTALS_TEST_MODE>",
        "CLOUDFLARE_ACCOUNT_ID": "<CLOUDFLARE_ACCOUNT_ID>",
        "CLOUDFLARE_API_TOKEN": "<CLOUDFLARE_API_TOKEN>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`POSTALS_API_KEY` Required, secret	Your Handwrytten API key (v1.0) or Postals API key (v1.1+).
`POSTALS_SENDER_NAME` Optional	Default sender full name for return address.
`POSTALS_SENDER_ADDRESS` Optional	Default sender street address.
`POSTALS_SENDER_CITY` Optional	Default sender city.
`POSTALS_SENDER_STATE` Optional	Default sender 2-letter US state code.
`POSTALS_SENDER_ZIP` Optional	Default sender 5-digit ZIP (or 5+4 format).
`POSTALS_DEFAULT_CARD_IMAGE` Optional	Default card front image URL (HTTPS, PNG or JPEG, landscape 7x5 preferred).
`POSTALS_HANDWRITING_STYLE` Optional	Default handwriting font. Default: Joyful Jennifer.
`POSTALS_DAILY_LIMIT` Optional	Max cards per day (safety net). Default: 50.
`POSTALS_TEST_MODE` Optional	Set to 'true' for test mode (validates inputs, no cards actually sent).
`CLOUDFLARE_ACCOUNT_ID` Optional	Optional. Enables AI message generation via Cloudflare Workers AI.
`CLOUDFLARE_API_TOKEN` Optional, secret	Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.

Details

Package	`[email protected]` (NPM, stdio)
First published	15 Apr 2026
Last updated	15 Apr 2026
Registry name	`io.github.coopergwrenn/postals-mcp`

More ai and media servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Postals Mcp often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-coopergwrenn-postals-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-coopergwrenn-postals-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.