Handwrytten — Send Real Handwritten Notes

---

name: Handwrytten

description: Send real handwritten notes through robots with real pens — physical cards mailed to recipients

metadata: {"openclaw":{"requires":{"env":["HANDWRYTTEN_API_KEY"],"bins":["node"]},"primaryEnv":"HANDWRYTTEN_API_KEY","emoji":"envelope","homepage":"https://github.com/handwrytten/handwrytten-mcp-server","install":[{"type":"node","package":"@handwrytten/mcp-server"}]}}

---

# Handwrytten — Send Real Handwritten Notes

You have access to the Handwrytten API, which sends real handwritten notes using robots with actual pens writing on physical cards that get mailed to recipients.

Typical Workflow

1. **Browse options first**: Call `list_cards` and `list_fonts` to discover available card templates and handwriting styles before sending.

2. **Send the note**: Call `send_order` with a card ID, font ID, message, and sender address and recipient address. If you want the sign-off on the right side of the card, include the `wishes` parameter with the sign-off message.

3. **Confirm to the user**: Always tell the user what card, font, and message you selected, and confirm before placing an order that costs money.

Key Tools

Sending Notes (Core)

Browsing Cards & Fonts

Address Book

Extras

Custom Cards (Advanced)

For creating custom card designs with logos, images, and printed text:

1. `list_custom_card_dimensions` — Get available card formats (flat/folded, portrait/landscape).

2. `upload_custom_image` — Upload a cover or logo image (JPEG/PNG/GIF via public URL).

3. `create_custom_card` — Build the card design with zones (header, main, footer, back). Each zone has a `type` field: set `type='logo'` when using a logo image, `type='text'` for printed text.

4. Use the resulting card ID with `send_order` to mail it.

QR Codes

Basket (Multi-Step Orders)

For building up multiple orders before submitting them together:

Important Guidelines