Integration

Handwrytten integration

Handwrytten mails real handwritten notes and cards, written by robots with a real pen. Send a card in one call (card, handwriting font, message, sender and recipient), or add orders for one or many address-book recipients to a basket and send it at once, track and cancel orders, browse the card catalog, handwriting fonts, inserts, gift cards and stamp options, manage recipient and sender addresses, and design custom cards with your own images, text and QR codes. Orders are paid from the account's credits or card on file; in test mode orders are accepted but not fulfilled, and payments are only authorized, never captured. Left out: the deprecated password login and logout, the prospecting (targeted mailing) routes, whose filter keys the vendor documents two different ways, and the sender-address update, which names no address. Authentication is an API key from the Integrations page, sent as the raw value of the Authorization header (no Bearer prefix).

Connect Handwrytten How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Handwrytten.Built from the 45 Handwrytten tools below, on the connection you add once.

What you can do with Handwrytten

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

List, 7 operations

list_bundlesList bundlesGETReturns the list of active, in-stock bundles, physical items (such as a box of cookies) shipped to your recipient together with your card.
list_card_categoriesList card categoriesGETGet list of available card categories.
list_cardsList cardsGETGet a list of all cards available to the user, including any custom or privately-available cards.
list_countriesList countriesGETReturns the list of all supported countries, including available states/provinces and delivery costs.
list_fontsList fontsGETReturns the list of available handwriting styles for use in orders. The `id` field is the font identifier to use in order calls; `label` is the human-readable name.
list_gift_cardsList gift cardsGETGet list of gift cards and available denominations for purchase and inclusion in order.
list_insertsList insertsGETGet list of custom inserts available for the account.

Qr code, 3 operations

create_qr_codeCreate qr codePOSTCreate a QR code that opens a URL, to print on custom cards with create_custom_card. Returns its id.
delete_qr_codeDelete qr codeDELETEDelete a QR Code.
list_qr_codesList qr codesGETGet a list of QR Codes on the account.

Add recipient, 1 operation

add_recipientAdd recipientPOSTAdd a new recipient address to user's Address Book.

Addres, 1 operation

get_default_sender_addressGet default sender addressGETGet user's default sender address.

Auth, 1 operation

check_authCheck authGETCheck that the API key is valid. Returns the account login and whether test mode is on.

Cancel, 1 operation

cancel_orderCancel orderPOSTCancel order by order id. Only orders with status `paid` can be canceled. Orders that have already been processed cannot be canceled and will return 400 error.

Check uploaded custom logo, 1 operation

check_custom_imageCheck custom imagePOSTValidates the print quality of an uploaded image. Returns a warning if the image resolution is below recommended, or an error if it is too low to use.

Clear, 1 operation

clear_basketClear basketPOSTRemoves all items from the basket. Returns the list of items that were cleared.

Count, 1 operation

count_basket_itemsCount basket itemsGETGet the number of items in the user's basket.

Create addres, 1 operation

add_sender_addressAdd sender addressPOSTAdd a new sender address to user's Address Book.

Create custom card, 1 operation

create_custom_cardCreate custom cardPOSTCreate a custom card design from uploaded images (upload_custom_image), preset covers, text and logos, and QR codes.

Dashboard, 1 operation

get_qr_code_statisticsGet qr code statisticsGETGet the scan statistics of the account's QR codes: totals, recent scans with location and card, and scans per date.

Delete, 1 operation

delete_custom_cardDelete custom cardPOSTDeletes a custom card created by the user.

Delete addres, 1 operation

delete_sender_addressDelete sender addressPOSTDelete one sender address (id) or several (address_ids) from the address book.

Delete custom logo, 1 operation

delete_custom_imageDelete custom imagePOSTDelete an image uploaded with upload_custom_image.

Delete recipient, 1 operation

delete_recipientDelete recipientPOSTDelete one recipient address (address_id) or several (address_ids) from the address book.

Detail, 1 operation

get_orderGet orderGETReturns full details for a given order, including status, recipient address, card, pricing, and delivery information.

Dimension, 1 operation

list_card_dimensionsList card dimensionsGETReturns available card sizes and formats. Use the `id` (dimension_id) when creating a custom card.

Fonts, 1 operation

list_customizer_fontsList customizer fontsGETList the fonts available for the text areas of custom cards (header, footer, inside and back). The id field is what create_custom_card takes as header_font_id, footer_font_id, main_font_id and back_font_id.

Frame, 1 operation

list_qr_code_framesList qr code framesGETGet a list of available QR Code frames.

Get user, 1 operation

get_userGet userGETGet the profile and account information of the user the API key belongs to, including name, email, billing address and remaining credits. The main use is checking the credit balance before sending cards.

List addresse, 1 operation

list_sender_addressesList sender addressesGETList the sender (return) addresses saved in the address book.

List custom user image, 1 operation

list_custom_imagesList custom imagesGETList all custom images uploaded by the user.

List state, 1 operation

list_statesList statesGETReturns the list of states or provinces for a given country.

Place basket, 1 operation

add_order_to_basketAdd order to basketPOSTAdd an order to the basket without submitting it, for one recipient or many: address_ids from the address book, or addresses given inline with their own message. Submit everything in the basket with send_basket.

Preset image, 1 operation

list_preset_cover_imagesList preset cover imagesGETReturns preset cover images available for a given card dimension.

Recipients list, 1 operation

list_recipientsList recipientsGETGet list of recipient addresses in user's Address Book.

Section, 1 operation

list_cards_by_categoryList cards by categoryGETGet a list of cards available to the user, grouped by categories.

Send, 1 operation

send_basketSend basketPOSTSubmits all orders currently in the basket for processing.

Set default addres, 1 operation

set_default_sender_addressSet default sender addressPOSTSet user's default sender address.

Set test mode, 1 operation

set_test_modeSet test modePOSTSwitches test mode on or off for the user associated with the API key. Pass `1` to enable test mode or `0` to return to live mode.

Signature, 1 operation

list_signaturesList signaturesGETReturns the list of signatures available to the user. Signature IDs can be used in order calls to include a signature in the message or wishes fields.

Single step order, 1 operation

send_cardSend cardPOSTSend one handwritten card in a single call: the card, the handwriting font, the message and closing, the return (sender) address and the recipient address. The order is created and submitted for writing and mailing, and its id is returned.

Stamp option, 1 operation

list_stamp_optionsList stamp optionsGETReturns the list of available stamp options. The `id` field is what's passed as `stamp_option_id` on order calls.

Update recipient, 1 operation

update_recipientUpdate recipientPUTUpdate a recipient address in Address Book.

Upload custom logo, 1 operation

upload_custom_imageUpload custom imagePOSTUpload an image for a custom card: type cover for the design printed on the outside, type logo for a logo in the header, footer or inside. Returns the image id and URL for create_custom_card.

View, 1 operation

get_cardGet cardGETGet detailed information about a card.

Use Handwrytten from Claude Code, Cursor or Codex

Connect Handwrytten in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Handwrytten operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Handwrytten

Create your workspace
Sign up free. Nothing to install.
Connect Handwrytten once
Add your Handwrytten connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.