Postals MCP Server

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 -- npx -y postals-mcp

{
  "mcpServers": {
    "postals-mcp": {
      "args": [
        "-y",
        "postals-mcp"
      ],
      "command": "npx"
    }
  }
}

[mcp_servers.postals-mcp]
command = "npx"
args = ["-y", "postals-mcp"]

{
  "mcpServers": {
    "postals-mcp": {
      "args": [
        "-y",
        "postals-mcp"
      ],
      "command": "npx"
    }
  }
}

{
  "mcpServers": {
    "postals-mcp": {
      "args": [
        "-y",
        "postals-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: POSTALS_API_KEY (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 (Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.). The author declared them in the registry entry; get the values from the project itself.