Handwrytten MCP server for AI agents and assistants

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.

Create my free account Get a demo

Handwrytten

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

Enter ↵

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.

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

Install Composio

typescript

npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp

Install the Composio SDK for Python or TypeScript

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

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

Install Composio

typescript

npm install @composio/openai

Install the Composio SDK

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

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

FRAMEWORKS

Use Handwrytten with any AI Agent Framework

Choose a Framework you want to connect Handwrytten with

OpenAI Agents SDK

Use Handwrytten MCP with OpenAI Agents SDK

Claude Agents SDK

Use Handwrytten MCP with Claude Agents SDK

Claude Code

Use Handwrytten MCP with Claude Code

Claude Cowork

Use Handwrytten MCP with Claude Cowork

Codex

Use Handwrytten MCP with Codex

OpenClaw

Use Handwrytten MCP with OpenClaw

Hermes

Use Handwrytten MCP with Hermes

Google ADK

Use Handwrytten MCP with Google ADK

Langchain

Use Handwrytten MCP with Langchain

AI SDK

Use Handwrytten MCP with AI SDK

Mastra AI

Use Handwrytten MCP with Mastra AI

LlamaIndex

Use Handwrytten MCP with LlamaIndex

CrewAI

Use Handwrytten MCP with CrewAI

Pydantic AI

Use Handwrytten MCP with Pydantic AI

Autogen

Use Handwrytten MCP with Autogen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Google Sheets

Oauth2

Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.

Notion

Oauth2Api Key

Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.

Airtable

Oauth2Api Key

Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.

Asana

Oauth2

Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.

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.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Handwrytten connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

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

Create the key in your Handwrytten account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the Handwrytten actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside Handwrytten at any time.

When you connect a Handwrytten account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Handwrytten as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside Handwrytten. If Handwrytten lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside Handwrytten at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Handwrytten connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment Handwrytten rejects the old key. Create a new key in Handwrytten and reconnect the account from the Composio dashboard or by asking your agent to reconnect Handwrytten. Nothing else changes.

Composio's free plan includes 100,000 tool calls per month with no credit card, which covers most personal Handwrytten use. Paid plans add higher limits and team features. Your Handwrytten plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Handwrytten accounts).

With Composio, you connect Handwrytten once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Handwrytten.It takes 30 seconds.

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

Start building

Handwrytten MCP server for AI agents and assistants

Try Handwrytten now

Supported Tools

Connect Handwrytten MCP Tool with your Agent

Install Composio

Initialize Client and Create Tool Router Session

Connect to AI Agent

Connect Handwrytten API Tool with your Agent

Install Composio

Initialize Composio and Create Tool Router Session

Execute Handwrytten Tools via Tool Router with Your Agent

Why Use Composio?

AI Native Handwrytten Integration

Managed Auth

Agent Optimized Design

Enterprise Grade Security

Use Handwrytten with any AI Agent Framework

OpenAI Agents SDK

Claude Agents SDK

Claude Code

Claude Cowork

Codex

OpenClaw

Hermes

Google ADK

Langchain

AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

Autogen

Explore Other Toolkits

Google Sheets

Notion

Airtable

Asana

Frequently asked questions

Do I need my own developer credentials to use Handwrytten with Composio?+

Can I use multiple toolkits together?+

Is Composio secure with my Handwrytten account?+

What if the API changes?+

Where do I get a Handwrytten API key, and who can see it?+

Does the agent act as me inside Handwrytten?+

Which Handwrytten permissions does the agent get?+

Can I use multiple Handwrytten accounts with Claude and ChatGPT?+

What happens if I rotate or revoke my Handwrytten API key?+

Does using Handwrytten through Composio cost extra?+

How is Composio different from the Handwrytten connectors already built into Claude and ChatGPT?+

Start with Handwrytten.It takes 30 seconds.