Handwrytten MCP server
55 operations0 webhooks
Automated handwritten notes, cards, and direct mail platform using robotics with real pens.
Try Handwrytten with your agent
Connect Handwrytten, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Handwrytten on my account, then run one read-only example and show me the result.
Handwrytten tools and triggers
Tools are what your agent can do in Handwrytten through Corsair's MCP server. Triggers are the Handwrytten events a routine can start from.
Address Book
- Add RecipientWrite
Add a new recipient address to the user address book
addressBook.addRecipient
- Add SenderWrite
Add a new sender return address to the account
addressBook.addSender
- CountriesRead-only
List supported destination countries and country codes for mailing
addressBook.countries
- Delete RecipientDestructive
Delete a recipient address from the user address book
addressBook.deleteRecipient
- Delete SenderDestructive
Delete a sender return address from the account
addressBook.deleteSender
- Get SenderRead-only
Get default sender return address and account billing info
addressBook.getSender
- List RecipientsRead-only
List saved recipient mailing addresses from the address book
addressBook.listRecipients
- List SendersRead-only
List saved return/sender addresses from the account
addressBook.listSenders
- Set Default SenderWrite
Set an address as the default sender return address
addressBook.setDefaultSender
- StatesRead-only
List states and provinces for a given country
addressBook.states
- Update RecipientDestructive
Update an existing recipient address in the user address book
addressBook.updateRecipient
- Update SenderDestructive
Update the sender return address on the account
addressBook.updateSender
Custom Cards
- Check ImageRead-only
Check image quality, resolution, and DPI for printing compatibility
customCards.checkImage
- CreateWrite
Create a custom card template with uploaded cover or inside artwork
customCards.create
- DeleteDestructive
Permanently delete a custom card template
customCards.delete
- Delete ImageDestructive
Delete a previously uploaded custom logo or image
customCards.deleteImage
- DimensionsRead-only
List supported card dimensions and print orientations for custom cards
customCards.dimensions
- List ImagesRead-only
List custom logos and user-uploaded images
customCards.listImages
- Preset ImagesRead-only
List preset cover images available for custom card design
customCards.presetImages
- Upload ImageWrite
Upload a custom logo or image for card customization
customCards.uploadImage
Templates
- CategoriesRead-only
List template categories available for card messages
templates.categories
- CreateWrite
Create a new saved message template in the user account
templates.create
- DeleteDestructive
Delete a message template from the user account
templates.delete
- GetRead-only
Get a specific message template by ID
templates.get
- ListRead-only
List saved message templates with optional category filter
templates.list
- UpdateDestructive
Update an existing message template in the user account
templates.update
Qr Codes
- CreateWrite
Create a dynamic trackable QR code to print on handwritten cards
qrCodes.create
- DashboardRead-only
Get scan analytics and statistics for created QR codes
qrCodes.dashboard
- DeleteDestructive
Delete a trackable QR code by ID
qrCodes.delete
- FramesRead-only
List decorative frame designs available for printed QR codes
qrCodes.frames
- ListRead-only
List trackable QR codes created in the account
qrCodes.list
Auth
- Check AuthRead-only
Check API key authentication status and whether test mode is active
auth.checkAuth
- Get UserRead-only
Get authenticated user profile details, email, and credit balance
auth.getUser
- LogoutWrite
Invalidate current session credentials
auth.logout
- Set Test ModeWrite
Enable or disable account test mode for simulating orders without fulfillment charges
auth.setTestMode
Cards
- CategoriesRead-only
List all card categories and taxonomies
cards.categories
- GetRead-only
Get details, dimensions, and cover image for a specific card
cards.get
- ListRead-only
List available greeting cards and designs with optional filtering and pagination
cards.list
- SectionsRead-only
List cards grouped by category sections
cards.sections
Orders
- Add To BasketWrite
Add a handwritten card order to the shopping basket for batch sending
orders.addToBasket
- CancelDestructive
Cancel an order before it enters robotic production
orders.cancel
- GetRead-only
Get status and details for an existing order by ID
orders.get
- Send SingleDestructive
Place a single real handwritten card order (spends credits and triggers robotic fulfillment)
orders.sendSingle
Basket
- ClearDestructive
Remove all pending orders and clear the shopping basket
basket.clear
- CountRead-only
Get current item count in the shopping basket
basket.count
- SendDestructive
Submit and charge all pending orders in the shopping basket for robotic fulfillment
basket.send
Prospecting
- Calculate TargetsRead-only
Calculate target recipient counts based on demographic and geographic filters
prospecting.calculateTargets
- Create OrderDestructive
Create a direct-mail prospecting campaign order with targeted recipient lists
prospecting.createOrder
- PreviewRead-only
Preview prospecting order pricing and recipient volume before sending
prospecting.preview
Bundles
- ListRead-only
List product bundles and gift pairings available to enclose with cards
bundles.list
Fonts
- ListRead-only
List available realistic handwriting font styles and stroke properties
fonts.list
Gift Cards
- ListRead-only
List physical merchant gift cards and denominations that can be enclosed in notes
giftCards.list
Inserts
- ListRead-only
List custom marketing inserts and business cards available for envelope insertion
inserts.list
Shipping
- Stamp OptionsRead-only
List postage stamp options (first-class vs presorted mail) and rates
shipping.stampOptions
Signatures
- ListRead-only
List user handwriting signatures saved on the account
signatures.list
Connect Handwrytten to Claude, ChatGPT or Cursor
- 1
Connect Handwrytten in Corsair
Add your Handwrytten API key once in Corsair. Corsair stores the credential encrypted and makes the Handwrytten API calls for your agent, so it never goes into a prompt or a config file. Connect Handwrytten
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Handwrytten. On a ChatGPT personal plan, connect Handwrytten here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Handwrytten's read and write operations run right away and its 14 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/handwrytten, add the Handwrytten plugin, and connect with an API key. Then call methods like corsair.handwrytten.api.addressBook.addRecipient() from your app. Corsair keeps each tenant isolated.
Yes. Handwrytten requires an API key from your Handwrytten account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Handwrytten, GitHub, Notion, Stripe, and the rest. Trigger Handwrytten from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for automated handwritten notes, cards, and direct mail platform using robotics with real pens. Common builds include sync jobs, admin tooling, and agents that call Handwrytten APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Handwrytten API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/handwrytten in the open repo. When Handwrytten ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Handwrytten data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Handwrytten data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Handwrytten on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 14 destructive Handwrytten operations. You can change a link's mode at hub.corsair.dev/me.