# Handwrytten

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

- Skill: `dvcrn/handwrytten` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add dvcrn/handwrytten`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/handwrytten/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/handwrytten

---


# 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)
- `send_order` — The primary tool. Sends a handwritten note. Supports single recipients (address object or saved ID) and bulk sends (array of recipients with optional per-recipient message overrides). Always call `list_cards` and `list_fonts` first.
- `get_order` / `list_orders` — Check order status and history.

### Browsing Cards & Fonts
- `list_cards` — Browse card templates. Supports filtering by category name/ID and search by name. Use `list_card_categories` to discover category IDs. Results are paginated (default 20/page).
- `list_fonts` — Browse handwriting styles for the order message.
- `list_customizer_fonts` — Browse printed/typeset fonts (only needed for custom card text zones, not for order messages).

### Address Book
- `list_recipients` / `add_recipient` / `update_recipient` / `delete_recipient` — Manage saved recipient addresses.
- `list_senders` / `add_sender` / `delete_sender` — Manage saved return addresses.
- `list_countries` / `list_states` — Look up supported countries and state codes.

### Extras
- `list_gift_cards` — Browse gift cards to attach to orders (pass `denominationId` to `send_order`).
- `list_inserts` — Browse physical inserts (business cards, flyers) to include in orders.
- `list_signatures` — List saved handwriting signatures.
- `calculate_targets` — Prospect mailing targets by ZIP code and radius.

### 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
- `create_qr_code` / `list_qr_codes` / `delete_qr_code` — Manage QR codes that can be placed on custom cards.
- `list_qr_code_frames` — Browse decorative frames for QR codes.

### Basket (Multi-Step Orders)
For building up multiple orders before submitting them together:
- `basket_add_order` → `basket_list` → `basket_send`
- Use `send_order` instead for simple single-step sends.

## Important Guidelines

- **Always browse before sending.** Call `list_cards` and `list_fonts` before `send_order` so you use valid IDs.
- **Confirm before ordering.** Sending a note costs money and results in a physical card being mailed. Always confirm the details with the user before calling `send_order`.
- **Addresses require:** firstName, lastName, street1, city, state, zip. Country defaults to US.
- **Bulk sends:** Pass an array of recipients to `send_order`. Each recipient can have per-recipient `message` and `wishes` overrides.
- **Scheduling:** Use the `dateSend` parameter (YYYY-MM-DD) to schedule a future send.
- **Account balance:** Call `get_user` to check the user's credits balance.