# How to connect Handwrytten to Grok Bot

```json
{
  "title": "How to connect Handwrytten to Grok Bot",
  "toolkit": "Handwrytten",
  "toolkit_slug": "handwrytten",
  "framework": "Grok Bot",
  "framework_slug": "grok-bot",
  "url": "https://composio.dev/toolkits/handwrytten/framework/grok-bot",
  "markdown_url": "https://composio.dev/toolkits/handwrytten/framework/grok-bot.md",
  "updated_at": "2026-10-04T16:10:00.329Z"
}
```

## Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.
This guide explains how to connect Handwrytten to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Handwrytten in plain language.

## Also integrate Handwrytten with

- [Claude Code](https://composio.dev/toolkits/handwrytten/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/handwrytten/framework/claude-cowork)
- [OpenAI Agents SDK](https://composio.dev/toolkits/handwrytten/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/handwrytten/framework/claude-agents-sdk)
- [Codex](https://composio.dev/toolkits/handwrytten/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/handwrytten/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/handwrytten/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/handwrytten/framework/atomic-agent)
- [Google ADK](https://composio.dev/toolkits/handwrytten/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/handwrytten/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/handwrytten/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/handwrytten/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/handwrytten/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/handwrytten/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/handwrytten/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/handwrytten/framework/autogen)

## TL;DR

Composio exposes 1,500+ apps to your Grok bot through a single connection, so you get:
- Connect to 1,500+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
- Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
- Handle large tool responses outside the model context to keep conversations lean.

## Connect Handwrytten to Grok Bot

### Connecting Handwrytten to Grok Bot
Once Grok Bot is set up, you connect Handwrytten entirely from its interface, and the whole flow takes under a minute.
### Set up Grok Bot
Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from [x.ai/bot](https://x.ai/bot) and sign in. An iPhone companion app is also available, and your bots sync across devices.
Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.
### Connect Handwrytten
### 1. Add the Composio plugin
Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.
[Add to Grok Bot](https://x.ai/bot/plugin/32661537)
Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.
### 2. Authenticate
Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.
Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.
### 3. Connect your Handwrytten account
Back in the chat, ask your bot to connect to Handwrytten or give it any Handwrytten task.
For example, ask it to:
- "Send a thank you card to John Doe"
- "Schedule a handwritten birthday note delivery"
- "List all pending Handwrytten orders"
It will prompt you to authenticate and authorize access.
That's it. Composio's tools are now available in your Grok bot, and your Handwrytten account is ready to use.

## What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.
With Composio Connect, your Grok bot can securely access apps like Handwrytten through MCP without you sharing account credentials directly with the agent.

## What is the Handwrytten MCP server, and what's possible with it?

The Handwrytten MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Handwrytten account. It provides structured and secure access to your cards, saved addresses, recipients, account details, and basket, so your agent can browse card designs, review recipients, check account information, inspect your basket, and add handwritten note orders on your behalf.
- Card selection: Have your agent browse available Handwrytten cards and help find a suitable design for your correspondence.
- Recipient lookup: Let the agent review previously saved recipients before preparing a handwritten note order.
- Address review: Direct your agent to retrieve the addresses associated with your account and confirm which one to use.
- Basket management: Instruct your agent to inspect your current basket and add a handwritten card order with your chosen message.
- Account verification: Have your agent confirm that your credentials work and retrieve details about the current Handwrytten user.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `HANDWRYTTEN_ADD_RECIPIENT` | 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. |
| `HANDWRYTTEN_CALCULATE_ORDER_TAXES` | 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). |
| `HANDWRYTTEN_CHECK_AUTH` | 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. |
| `HANDWRYTTEN_CLEAR_BASKET` | 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. |
| `HANDWRYTTEN_CREATE_TEMPLATE` | 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. |
| `HANDWRYTTEN_CREATE_USER_ADDRESS` | 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. |
| `HANDWRYTTEN_DELETE_CUSTOM_IMAGE` | Delete Custom Image | 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. |
| `HANDWRYTTEN_DELETE_RECIPIENT_ADDRESS` | Delete Recipient Address | 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. |
| `HANDWRYTTEN_DELETE_TEMPLATE` | Delete Template | Tool to delete a user's template by its ID. Use when you need to remove a saved template from the user's account. |
| `HANDWRYTTEN_GET_BASKET_NEW_METHOD` | 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. |
| `HANDWRYTTEN_GET_BASKET_COUNT` | 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. |
| `HANDWRYTTEN_GET_BASKET_ITEM` | 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. |
| `HANDWRYTTEN_GET_CARD_DETAILS` | 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. |
| `HANDWRYTTEN_GET_LIST_OF_ADDRESSES` | 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. |
| `HANDWRYTTEN_GET_RANDOM_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. |
| `HANDWRYTTEN_GET_TEMPLATE_DETAILS` | 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. |
| `HANDWRYTTEN_GET_CURRENT_USER_INFO` | 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. |
| `HANDWRYTTEN_GET_USER_ADDRESS` | Get User Address | Tool to retrieve the authenticated user's address and billing information. Use when you need to access user profile address details. |
| `HANDWRYTTEN_LIST_BASKET_ORDERS_GROUPED` | 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. |
| `HANDWRYTTEN_LIST_PAST_BASKETS` | 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. |
| `HANDWRYTTEN_LIST_CARDS` | 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. |
| `HANDWRYTTEN_LIST_CATEGORIES` | 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. |
| `HANDWRYTTEN_LIST_COUNTRIES` | List Countries | Tool to retrieve the list of countries available in Handwrytten. Use when you need to get available countries for sending handwritten cards. |
| `HANDWRYTTEN_LIST_CREDIT_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. |
| `HANDWRYTTEN_LIST_FONTS` | 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. |
| `HANDWRYTTEN_LIST_FONTS_FOR_CUSTOMIZER` | 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. |
| `HANDWRYTTEN_LIST_GIFT_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. |
| `HANDWRYTTEN_LIST_CUSTOM_USER_IMAGES` | 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. |
| `HANDWRYTTEN_LIST_INSERTS` | 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. |
| `HANDWRYTTEN_LIST_ORDERS` | 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. |
| `HANDWRYTTEN_LIST_ORDERS_GROUPED` | List Orders Grouped | Tool to retrieve the user's order history grouped by basket. Use when you need to view or analyze past orders. |
| `HANDWRYTTEN_LIST_PAST_ORDERS` | 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. |
| `HANDWRYTTEN_LIST_RECIPIENTS` | 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. |
| `HANDWRYTTEN_LIST_SIGNATURES` | 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. |
| `HANDWRYTTEN_LIST_STATES` | 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. |
| `HANDWRYTTEN_LIST_TEMPLATE_CATEGORIES` | 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. |
| `HANDWRYTTEN_LIST_TEMPLATES` | 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. |
| `HANDWRYTTEN_LOGOUT_USER` | Logout User | Tool to logout user from Handwrytten application. Use when you need to terminate the current user session and invalidate the authentication token. |
| `HANDWRYTTEN_PLACE_ORDER_IN_BASKET` | 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 delivery. |
| `HANDWRYTTEN_REGISTER_USER` | 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. |
| `HANDWRYTTEN_REQUEST_PASSWORD_RESET` | 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 exists in the system, but will return success regardless to prevent email enumeration attacks. |
| `HANDWRYTTEN_SET_DEFAULT_ADDRESS` | 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. |
| `HANDWRYTTEN_SET_TEST_MODE` | 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. |
| `HANDWRYTTEN_UPDATE_BASKET_ITEM` | 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. |
| `HANDWRYTTEN_UPDATE_BILLING_INFORMATION` | 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. |
| `HANDWRYTTEN_UPDATE_RECIPIENT` | 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. |
| `HANDWRYTTEN_UPDATE_TEMPLATE` | Update Template | Tool to update an existing user template in Handwrytten. Use when you need to modify a template's name or message content. |
| `HANDWRYTTEN_UPLOAD_CUSTOM_LOGO` | 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. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

Once connected, your Grok bot can access the Handwrytten MCP server through Composio to run the actions you authorize, using plain language in the chat.

## Complete Code

None listed.

## Conclusion

### Way Forward
Now that Handwrytten is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.
- Connect Calendar to turn threads into scheduled meetings automatically.
- Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
- Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
- Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.
Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

## How to build Handwrytten MCP Agent with another framework

- [Claude Code](https://composio.dev/toolkits/handwrytten/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/handwrytten/framework/claude-cowork)
- [OpenAI Agents SDK](https://composio.dev/toolkits/handwrytten/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/handwrytten/framework/claude-agents-sdk)
- [Codex](https://composio.dev/toolkits/handwrytten/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/handwrytten/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/handwrytten/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/handwrytten/framework/atomic-agent)
- [Google ADK](https://composio.dev/toolkits/handwrytten/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/handwrytten/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/handwrytten/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/handwrytten/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/handwrytten/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/handwrytten/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/handwrytten/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/handwrytten/framework/autogen)

## Related Toolkits

- [Google Sheets](https://composio.dev/toolkits/googlesheets) - 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](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.
- [Airtable](https://composio.dev/toolkits/airtable) - 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](https://composio.dev/toolkits/asana) - 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.
- [Google Tasks](https://composio.dev/toolkits/googletasks) - Google Tasks is a to-do list and task management tool integrated into Gmail and Google Calendar. It helps you organize, track, and complete tasks across your Google ecosystem.
- [Linear](https://composio.dev/toolkits/linear) - Linear is a modern issue tracking and project planning tool for fast-moving teams. It helps streamline workflows, organize projects, and boost productivity.
- [Jira](https://composio.dev/toolkits/jira) - Jira is Atlassian’s platform for bug tracking, issue tracking, and agile project management. It helps teams organize work, prioritize tasks, and deliver projects efficiently.
- [Clickup](https://composio.dev/toolkits/clickup) - ClickUp is an all-in-one productivity platform for managing tasks, docs, goals, and team collaboration. It streamlines project workflows so teams can work smarter and stay organized in one place.
- [Monday](https://composio.dev/toolkits/monday) - Monday.com is a customizable work management platform for project planning and collaboration. It helps teams organize tasks, automate workflows, and track progress in real time.
- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Adobe Marketing Agent MCP](https://composio.dev/toolkits/adobe_marketing_agent_mcp) - Adobe Marketing Agent MCP is Adobe's hosted MCP service that exposes marketing context, preferences, and agent capabilities. Use it to provide agents with campaign, audience, and analytics context via a managed integration.
- [Aeroleads](https://composio.dev/toolkits/aeroleads) - Aeroleads is a B2B lead generation platform for finding business emails and phone numbers. Grow your sales pipeline faster with powerful prospecting tools.
- [Agiled](https://composio.dev/toolkits/agiled) - Agiled is an all-in-one business management platform for CRM, projects, and finance. It helps you streamline workflows, consolidate client data, and manage business processes in one place.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [AimTell](https://composio.dev/toolkits/aimtell) - AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics. Use it to send targeted browser notifications and measure engagement across your web push campaigns.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Handwrytten MCP?

With a standalone Handwrytten MCP server, the agents and LLMs can only access a fixed set of Handwrytten tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Handwrytten and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Grok Bot?

Yes, you can. Grok Bot fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Handwrytten tools.

### Can I manage the permissions and scopes for Handwrytten while using Tool Router?

Yes, absolutely. You can configure which Handwrytten scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Handwrytten data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)