Handwrytten
Automate your handwritten correspondence. Send real notes with your message written in pen by robots.
Verdict
Common use cases
- Send thank-you cards after sales calls
- Automate birthday cards for customers
- Queue holiday greetings in bulk
- Personalize onboarding welcome notes
- Trigger apology cards from support tickets
Integration
- Vendor
- Handwrytten
- Category
- other
- Auth
- API_KEY
- Tools
- 48
- Composio slug
handwrytten
Tools
- Add Recipient
Tool to add a recipient address to the user's addressbook in Handwrytten. Use when you need to store a new recipient for sending handwritten cards.
- Calculate Order Taxes
Tool to calculate taxes for Handwrytten basket orders. Use without any parameters for basket orders, or optionally provide order details to calculate taxes for a specific order (experimental).
- Check Authentication
Tool to verify API key authentication validity for Handwrytten. Use when you need to test if the API credentials are valid and properly configured.
- Clear Basket
Tool to clear all items from the shopping basket. Use when you need to empty the basket and remove all pending items before starting a new order or canceling the current selection.
- Create Template
Tool to create a new template for the current user. Use when you need to save a new message template for sending handwritten cards.
- Create User Address
Tool to create a new user address in Handwrytten. Use when adding a new return address to a user's profile for sending handwritten cards.
- Delete Custom Imagedestructive
Tool to delete a custom image/logo from Handwrytten. Use when you need to remove a previously uploaded custom image or logo from your account.
- Delete Recipient Addressdestructive
Tool to delete one or more recipient addresses from user's profile. Use when you need to remove saved recipient addresses. Provide either address_id for single deletion or address_ids for bulk deletion.
- Delete Templatedestructive
Tool to delete a user's template by its ID. Use when you need to remove a saved template from the user's account.
- Get Basket Count
Tool to retrieve the count of items currently in the basket. Use when you need to check how many items are in the shopping basket before proceeding with checkout or additional operations.
- Get Basket Item
Tool to retrieve a basket item by its ID from Handwrytten. Use when you need to get details of a specific basket item.
- Get Basket (New Method)
Tool to retrieve the user's basket using the new method. Use when you need to fetch the current state of the shopping basket with all items, billing information, and totals.
- Get Card Details
Tool to get detailed information about a specific card in the Handwrytten catalog. Use when you need comprehensive details about a card including pricing, dimensions, images, and customization options.
- Get Current User Info
Tool to retrieve information about the currently authenticated user. Use when you need to fetch user profile details, account information, or verify authentication status.
- Get List of Addresses
Tool to retrieve a list of all addresses associated with the user's account. Use when you need to view or select from saved addresses for sending handwritten cards.
- Get Random Cards
Tool to retrieve random cards from Handwrytten. Use when you need to get a random selection of greeting cards from the Handwrytten catalog.
- Get Template Details
Tool to get detailed information about a card text template in the Handwrytten catalog. Use when you need to view the template message content and details.
- Get User Address
Tool to retrieve the authenticated user's address and billing information. Use when you need to access user profile address details.
- List Basket Orders Grouped
Tool to list all basket orders grouped by basket. Use when you need to retrieve all items currently in the user's basket or review pending orders.
- List Cards
Tool to retrieve a list of available Handwrytten cards with optional filtering and pagination. Use when browsing card catalog or searching for specific card types.
- List Categories
Tool to retrieve the list of available card categories from Handwrytten. Use when you need to display category options or filter cards by category.
- List Countries
Tool to retrieve the list of countries available in Handwrytten. Use when you need to get available countries for sending handwritten cards.
- List Credit Cards
Tool to list all credit cards associated with the Handwrytten account. Use when you need to retrieve stored payment methods and billing information.
- List Custom User Images
Tool to retrieve a list of custom user images uploaded to Handwrytten. Use when you need to browse or manage custom cover images or logos.
- List Fonts
Tool to retrieve the list of available handwriting fonts. Use when you need to display font options or select a font for a handwritten message.
- List Fonts for Customizer
Tool to list fonts available for use with the card customizer. Use when you need to retrieve available font options for customizing handwritten cards.
- List Gift Cards
Tool to retrieve the list of available gift cards with their denominations and pricing. Use when you need to see what gift card options are available for purchase through the Handwrytten API.
- List Inserts
Tool to retrieve a list of available inserts from Handwrytten. Use when you need to view all inserts that can be included with handwritten cards.
- List Orders
Tool to retrieve a list of user's past orders from Handwrytten. Use when you need to view order history or check the status of previously placed orders.
- List Orders Grouped
Tool to retrieve the user's order history grouped by basket. Use when you need to view or analyze past orders.
- List Past Baskets
Tool to retrieve a list of user's past baskets. Use when you need to view historical basket information including orders, recipients, and totals.
- List Past Orders
Tool to retrieve a list of user's past orders from Handwrytten API. Use when you need to view order history or check the status of previously placed orders.
- List Recipients
Tool to retrieve a list of recipient addresses that the user has previously saved. Use when you need to view or select from saved recipient addresses for sending handwritten cards.
- List Signatures
Tool to retrieve the list of available signatures for use in card orders. Use when you need to display signature options or select a signature for a handwritten message.
- List States
Tool to retrieve the list of states/provinces available in Handwrytten. Use when you need to get available states for addressing handwritten cards.
- List Template Categories
Tool to retrieve the list of available template categories from Handwrytten. Use when you need to display template category options or filter templates by category.
- List Templates
Tool to retrieve a list of card text templates from Handwrytten. Use when you need to display available templates or filter templates by category.
- Logout User
Tool to logout user from Handwrytten application. Use when you need to terminate the current user session and invalidate the authentication token.
- Place Order in Basket
Tool to add an order to the basket in Handwrytten. Use when you need to create a new handwritten card order with specified recipients, card design, message, and delivery details. The order can be placed immediately or scheduled for future d
- Register User
Tool to register a new Handwrytten user account. Use when creating a new user with email and password. Sends activation email to user; user status is not_active until email is confirmed.
- Request Password Reset
Tool to request a password reset email for a Handwrytten account. Use when a user needs to reset their password and requires an email with reset instructions. The API will send an email with a password reset link if the provided email exist
- Set Default Address
Tool to set a default return address for the user in Handwrytten. Use when you need to designate a specific address as the default return address for sending handwritten cards.
- Set Test Mode
Tool to set test mode for the current Handwrytten user. Use when you need to enable or disable test mode for testing purposes. When enabled, cards will not be sent and money will be returned to the credit card.
- Update Basket Item
Tool to update an existing basket item in Handwrytten. Use when you need to modify card details, recipient addresses, messages, or other basket item properties.
- Update Billing Information
Tool to update user billing information (country, zip, address) for tax calculations in Handwrytten. Use when updating billing address details for accurate tax computation.
- Update Recipient
Tool to update a recipient address in the user's addressbook in Handwrytten. Use when you need to modify an existing recipient's address details.
- Update Template
Tool to update an existing user template in Handwrytten. Use when you need to modify a template's name or message content.
- Upload Custom Logo
Tool to upload a custom image (logo or cover) to Handwrytten for use with custom cards. Use when you need to add a custom logo or cover image that can be referenced in future card creation requests.
Setup
Setup guide
- 11. Log into your Handwrytten account at handwrytten.com and navigate to Settings → API to generate an API key. 2. In Switchy, open any Space and click the MCP icon in the sidebar, then search for Handwrytten. 3. Click Connect and paste your API key when prompted. 4. Switchy validates the key by calling the authentication check tool — you'll see a green checkmark if it succeeds. 5. To test, type '@Handwrytten list my recipient addresses' in the Space chat. 6. If addresses appear (or you get an empty list), the connection works. 7. You can now @mention Handwrytten to add recipients, browse card designs, compose messages, calculate taxes, and place orders directly from any Space conversation.
What teammates see: by default, memories from Handwrytten are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Add New Recipient
@Handwrytten add a recipient: Jane Doe, 123 Main St, Austin TX 78701. Label this address 'Q1 Demo Lead'.Open in a Space →
Draft Thank-You Card
@Handwrytten I need to send a thank-you card to the recipient labeled 'Q1 Demo Lead'. Draft a short message thanking them for the call and show me card design options.Open in a Space →
Calculate Order Cost
@Handwrytten calculate the total cost and taxes for sending one card to zip code 78701 with standard shipping.Open in a Space →
Bulk Birthday Cards
@Handwrytten send birthday cards to all recipients tagged 'VIP Customer'. Use the template 'Birthday Greeting 2024' and schedule them for next Monday.Open in a Space →
Clear Pending Orders
@Handwrytten clear my basket. I want to start a new order from scratch.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Handwrytten add Sarah Chen at 742 Evergreen Terrace, Springfield, IL 62704 to my address book for future holiday cards
I've added Sarah Chen to your Handwrytten address book with the Springfield, IL address you provided. This recipient is now saved and can be selected for future card orders without re-entering the details. You can reference this address by name when creating orders, or browse your full address book to manage saved recipients.
This example shows the address-book management capability, which is useful for teams sending recurring cards (client gifts, employee recognition). Requires a valid API key. Note that adding an address doesn't send a card — it's a separate step to add items to your basket and place an order.
@Handwrytten create a thank-you card template that says 'Thanks for being an incredible partner this year. Looking forward to what we'll build together in 2025!' and save it as Q4_Partner_Thanks
I've created and saved the template 'Q4_Partner_Thanks' in your Handwrytten account. The message reads: 'Thanks for being an incredible partner this year. Looking forward to what we'll build together in 2025!' You can now reference this template by name when placing bulk card orders, which saves time if you're sending the same message to multiple recipients.
Template creation is a write action that persists in your Handwrytten account. This is powerful for teams running seasonal campaigns or standardized outreach (onboarding cards, milestone recognition). The template stores the message text; you'll still select card style, handwriting font, and recipients when placing the actual order.
@Handwrytten show me what's currently in my basket, calculate the taxes, and tell me if I'm ready to place this order or if anything's missing
Your Handwrytten basket currently contains 3 items: two 'Classic Thank You' cards addressed to recipients in California, and one 'Birthday Celebration' card going to Texas. The estimated tax for this order is $2.47 based on the delivery states. You're ready to place the order — all items have valid recipient addresses and card selections. However, confirm your return address is set in your user profile, as Handwrytten requires a sender address for physical mail.
This synthesis example pairs the MCP's basket-read and tax-calculation tools with the AI's ability to audit order readiness. Useful before committing to a card send, especially for teams managing budgets or compliance. The tax calculation is an estimate; final charges appear at checkout. Basket state persists across sessions until you clear it or complete the order.
Use-case deep-dives
When handwritten cards beat email for retention touchpoints
A 6-person consulting firm sends 40-80 thank-you cards to clients each December. The Handwrytten MCP wins here because the team stores recipient addresses once (Add Recipient), templates three message variants (Create Template), and queues batches without leaving Slack or their CRM workspace. The 48-tool scope handles edge cases like tax calculation for international orders and logo uploads for branded stationery. This works when card volume justifies API overhead—if you're sending fewer than 20 cards a quarter, the Handwrytten web UI is faster than wiring up the MCP. But for teams running regular touchpoint campaigns (onboarding gifts, renewal milestones, referral thanks), the MCP turns card-sending into a repeatable workflow instead of a monthly scramble. If your close rate on handwritten follow-ups is above 12%, automate it.
Scaling personal outreach without hiring an assistant
A solo real estate agent closes 18 deals a year and hand-writes 6 cards per closed transaction (buyer, seller, referral source, two neighbors, one lender). The Handwrytten MCP is overkill for this volume—48 tools to send 108 cards annually means you're paying integration tax for convenience you don't need. The breakeven is around 300 cards a year, or a 4-agent team where one person queues cards for everyone. At that scale, the MCP's basket management (Clear Basket, Calculate Order Taxes) and bulk address operations (Delete Recipient Address with address_ids) justify the setup cost. Below that threshold, use Handwrytten's native app or a Zapier bridge. The MCP is for teams who treat cards as a pipeline stage, not a nice-to-have gesture.
When compliance and branding requirements demand API control
A 40-person startup hires 8-12 people per quarter and sends each new hire a handwritten welcome card with a custom logo on day one. The Handwrytten MCP fits this scenario because HR needs to trigger cards from BambooHR or Greenhouse without manual data entry, and the Delete Custom Image and Create User Address tools let them rotate seasonal branding and return addresses across office locations. The MCP's Check Authentication tool also supports compliance audits—HR can verify API access is scoped correctly before each quarter's hiring wave. This setup makes sense when onboarding is templatized and card-sending is a required step, not an optional flourish. If your new-hire volume is under 20 per year, the manual workflow is fine. Above that, the MCP turns welcome cards into infrastructure.
Frequently asked
What does the Handwrytten MCP do in Switchy?
It lets AI agents send physical handwritten cards through Handwrytten's service. Your team can ask an agent to mail thank-you notes, birthday cards, or follow-up letters to clients without leaving the conversation. The MCP handles recipient management, card selection, basket operations, and order placement — essentially the full Handwrytten workflow from address lookup to shipping.
Do I need a Handwrytten account to use this MCP?
Yes. You need an active Handwrytten account and an API key from their dashboard. Paste the API key into Switchy's connection form. The MCP uses API_KEY auth, so there's no OAuth flow — just copy-paste credentials. Whoever connects it should have billing permissions in Handwrytten, since agents can place orders that charge your account.
Can the MCP customize handwriting styles or add logos?
Yes. The 48 tools include template creation, custom image upload, and handwriting style selection. Agents can reference saved templates, attach logos to cards, and choose from Handwrytten's handwriting fonts. They can't generate new handwriting styles — you're limited to what Handwrytten offers — but they can mix and match existing options programmatically.
Why use this instead of Handwrytten's web dashboard?
Speed and context. An agent can pull a client's address from your CRM, draft a card based on recent meeting notes, and queue it for mailing in one prompt. The dashboard requires manual data entry and tab-switching. Use the MCP when you're sending cards as part of a larger workflow; use the dashboard for one-off custom designs.
Who on the team should connect this MCP?
Someone with Handwrytten billing access and authority to approve physical mail spend. Agents can place orders that cost real money per card. If your team sends cards regularly — sales follow-ups, client gifts — connect it. If you send one card per quarter, the overhead isn't worth it.