Handwrytten MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Handwrytten MCP or direct API to send handwritten notes, schedule personalized card deliveries, manage templates, and track order status through natural language.

Handwrytten logoHandwrytten
Api Key

Handwrytten automates handwritten cards and notes using robotic penmanship. Save time while adding a personal touch to your customer or team communications.

48 Tools

Try Handwrytten now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Handwrytten
Try asking
TOOLS

Supported Tools

Every Handwrytten action and event your agent gets out of the box.

Add Recipient

Tool to add a recipient address to the user's addressbook in Handwrytten.

Calculate Order Taxes

Tool to calculate taxes for Handwrytten basket orders.

Check Authentication

Tool to verify API key authentication validity for Handwrytten.

Clear Basket

Tool to clear all items from the shopping basket.

Create Template

Tool to create a new template for the current user.

Create User Address

Tool to create a new user address in Handwrytten.

Delete Custom Image

Tool to delete a custom image/logo from Handwrytten.

Delete Recipient Address

Tool to delete one or more recipient addresses from user's profile.

Delete Template

Tool to delete a user's template by its ID.

Get Basket (New Method)

Tool to retrieve the user's basket using the new method.

Get Basket Count

Tool to retrieve the count of items currently in the basket.

Get Basket Item

Tool to retrieve a basket item by its ID from Handwrytten.

Get Card Details

Tool to get detailed information about a specific card in the Handwrytten catalog.

Get List of Addresses

Tool to retrieve a list of all addresses associated with the user's account.

Get Random Cards

Tool to retrieve random cards from Handwrytten.

Get Template Details

Tool to get detailed information about a card text template in the Handwrytten catalog.

Get Current User Info

Tool to retrieve information about the currently authenticated user.

Get User Address

Tool to retrieve the authenticated user's address and billing information.

List Basket Orders Grouped

Tool to list all basket orders grouped by basket.

List Past Baskets

Tool to retrieve a list of user's past baskets.

List Cards

Tool to retrieve a list of available Handwrytten cards with optional filtering and pagination.

List Categories

Tool to retrieve the list of available card categories from Handwrytten.

List Countries

Tool to retrieve the list of countries available in Handwrytten.

List Credit Cards

Tool to list all credit cards associated with the Handwrytten account.

List Fonts

Tool to retrieve the list of available handwriting fonts.

List Fonts for Customizer

Tool to list fonts available for use with the card customizer.

List Gift Cards

Tool to retrieve the list of available gift cards with their denominations and pricing.

List Custom User Images

Tool to retrieve a list of custom user images uploaded to Handwrytten.

List Inserts

Tool to retrieve a list of available inserts from Handwrytten.

List Orders

Tool to retrieve a list of user's past orders from Handwrytten.

List Orders Grouped

Tool to retrieve the user's order history grouped by basket.

List Past Orders

Tool to retrieve a list of user's past orders from Handwrytten API.

List Recipients

Tool to retrieve a list of recipient addresses that the user has previously saved.

List Signatures

Tool to retrieve the list of available signatures for use in card orders.

List States

Tool to retrieve the list of states/provinces available in Handwrytten.

List Template Categories

Tool to retrieve the list of available template categories from Handwrytten.

List Templates

Tool to retrieve a list of card text templates from Handwrytten.

Logout User

Tool to logout user from Handwrytten application.

Place Order in Basket

Tool to add an order to the basket in Handwrytten.

Register User

Tool to register a new Handwrytten user account.

Request Password Reset

Tool to request a password reset email for a Handwrytten account.

Set Default Address

Tool to set a default return address for the user in Handwrytten.

Set Test Mode

Tool to set test mode for the current Handwrytten user.

Update Basket Item

Tool to update an existing basket item in Handwrytten.

Update Billing Information

Tool to update user billing information (country, zip, address) for tax calculations in Handwrytten.

Update Recipient

Tool to update a recipient address in the user's addressbook in Handwrytten.

Update Template

Tool to update an existing user template in Handwrytten.

Upload Custom Logo

Tool to upload a custom image (logo or cover) to Handwrytten for use with custom cards.

SETUP GUIDE

Connect Handwrytten MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Handwrytten
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Send a birthday card to Alex at 456 Oak Avenue.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Handwrytten API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Handwrytten Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Send a thank you card to Jane Smith at 123 Main St.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Handwrytten actions with your Agent

Why Use Composio?

AI Native Handwrytten Integration

  • Supports both Handwrytten MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Handwrytten data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Handwrytten access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Handwrytten
  • Scoped, least privilege access to Handwrytten resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Handwrytten requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Handwrytten.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Handwrytten tool your agent needs.Free to start.

Start building