Postals MCP

Send physical handwritten postcards from any MCP-compatible AI agent - Claude Desktop, Cursor, Claude Code, OpenClaw, n8n, LangChain, CrewAI, or your own code. Postals handles image upload, card creation, robotic handwriting (real pen and ink), and USPS mailing. It runs locally over stdio via the published package.

People who work with agent skill, direct mail and handwritten and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-04-16 · ★ 2 · #79 OF 106 MAINTAINED AI & ML · VERIFIED 2026-09-18

MIT · JavaScript servers · how we verify → /methodology

01 · Install Postals MCP

before you install - you'll need

Set POSTALS_API_KEY before connecting. POSTALS_SENDER_NAME, POSTALS_SENDER_ADDRESS, POSTALS_SENDER_CITY, POSTALS_SENDER_STATE, POSTALS_SENDER_ZIP, POSTALS_TEST_MODE, CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_API_TOKEN are optional or environment-specific per the README.

Claude Code

claude mcp add coopergwrenn-postals-mcp -- npx -y postals-mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package postals-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.coopergwrenn is GitHub-verified and matches the repo owner

03 · What Postals MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 2 documented tools across run & execute, generate, including send_postcard, generate_message.

The 2 tools it gives your agent

Extracted from the project's README - what postals-mcp lets an agent do.

send_postcard: - Mails one physical handwritten postcard to a US address.
generate_message: - AI-drafts a personalized postcard message. Uses Cloudflare AI if configured; otherwise returns a structured prompt your agent can use to self-generate (which is

04 · Who maintains Postals MCP

postals-mcp is maintained by coopergwrenn. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/coopergwrenn/postals-mcp
category: AI & ML - ranked #79 of 106 actively-maintained AI & ML servers as of 2026-09-18.
registry: io.github.coopergwrenn/postals-mcp (active, first published 2026-04-15)
packages: npm:postals-mcp

06 · Postals MCP FAQ

What is Postals MCP?

Is Postals MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-04-16. We re-verify nightly.

How do I install Postals MCP?

Run `npx -y postals-mcp`. The README documents 9 environment variables (POSTALS_API_KEY, POSTALS_SENDER_NAME, POSTALS_SENDER_ADDRESS…) to set first. Set POSTALS_API_KEY before connecting. POSTALS_SENDER_NAME, POSTALS_SENDER_ADDRESS, POSTALS_SENDER_CITY, POSTALS_SENDER_STATE, POSTALS_SENDER_ZIP, POSTALS_TEST_MODE, CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_API_TOKEN are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Postals MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Postals MCP

Alternatives to Postals MCP

Maintained AI & ML servers if Postals MCP isn't the fit.

Pairs well with

Servers that cover what Postals MCP doesn't - only shown when the pairing reason fits the companion.

More AI & ML MCP servers · Connapse · Dagpipe · Contextweaver (dgenio) · DeepSeek MCP Server · Doc Slicer

More JavaScript MCP servers · Solana Security Standard · YouTube Research MCP · Crawleo MCP · Creative Claw · Mailbridge · see all