Skip to main content
Browse documentation

Type to search the documentation. Press Esc to close.

How do I send handwritten cards from Claude, ChatGPT or Gemini?

Add https://scribblecards.com/api/mcp as a connector in Claude, ChatGPT, Gemini Enterprise or any MCP-compatible assistant, then sign in to Scribble and choose what it may do. From then on you can ask your assistant to send a real handwritten card — using your credits, your handwriting, your address book and any card from our card collection — and it can show you a picture of the card, in that handwriting, before anything is posted.

On this page

#The server URL

Paste this into your assistant
https://scribblecards.com/api/mcp

That one URL is the whole configuration. There is no key to generate, nothing to install, and nothing to run on your own machine — you sign in to Scribble in a browser window the first time, tick what the assistant may do, and that is it.

#What is MCP?

The Model Context Protocol is an open standard for letting an AI assistant use an outside service. Anthropic published it, and OpenAI, Google and Microsoft have all adopted it, which means one connection works across the assistants your team already uses rather than needing a separate plugin for each.

For you it means the assistant can do things in Scribble, not just talk about them: read your address book, check your credits, and put a card in the post.

#Set it up

  1. Add the connector in your assistant

    Find the connectors or apps setting, choose to add a custom one, and paste https://scribblecards.com/api/mcp. The exact clicks differ per platform — see Claude, ChatGPT or Gemini.

  2. Sign in to Scribble

    A Scribble window opens. Sign in the way you normally do. If you are already signed in it skips straight to the next step.

  3. Choose what the assistant may do

    You will see four permissions, each with a tick box. Untick anything you do not want. If you leave Send handwritten cards off, the assistant can help you draft and look things up but cannot post anything.

    Choose the space this assistant should use. Just me is private; shared spaces have their own contacts, designs and credit balance. The connection stays with the space you approve, even when you switch spaces in the app.

    You’ll know it worked when Your assistant reports the connector as connected, and the Scribble tools appear in its tool list.

  4. Try it

    Ask: "Using Scribble, how many card credits do I have?" A working connection answers with a number.

#Things to try

  • Send a handwritten thank-you to Dana Fields — she is in my Scribble contacts — for the introduction to Ravi last week.
  • What cards do you have for thanking a client? Pick a nice one.
  • Draft a handwritten note to our five newest customers, and show me a couple of the real ones before any of them go.
  • Which handwriting styles do you have that look like a fountain pen? Show me.
  • Show me what that card will look like before we send it.
  • Where has card SC-NH4DERB got to?
  • Check this address is postable before we spend a credit on it.

#You see the card, not a description of it

Your assistant can show you a picture of the inside of the card, as the pen will write it. The handwriting in that picture is not a font pretending to be handwriting — it is drawn from the same pen strokes the machine follows, at the size and in the place the machine will put them, in the hand you chose. The printed front comes back as a link to the artwork rather than as a second picture, because that one already exists on our site.

Ask for a preview before sending, using check_card_before_sending. Preparing a batch also returns two sample card previews. Review the front, message, recipient and cost before telling your assistant to send.

Each preview includes a link you can open if your assistant does not display the image. The link works for 30 days. Anyone you share it with can see the card and its message.

Two things about it are worth knowing. The letters are varied for every card, so the card that arrives is in that handwriting but is not that exact drawing. And anything your design writes on every card — a logo line, a standing sign-off — is in the picture too, because it will be on the paper.

#Every card has a printed front

Every card has a printed front. Your assistant can choose from your organization's saved designs and the full public collection. Ask to see the cards for an occasion, then choose the one you want to send.

Choose a card from the collection without saving it first. It is added to this space's Designs when used. If no design is specified, the send uses your most recent saved design, so ask to see the front before approving.

The collection includes cards for personal occasions and for work. Business suitability is a way to narrow the choice, and birthday cards appear together whatever the recipient. Your organization's uploaded designs stay private to your organization.

Cards sent through an assistant use Scribble's shared handwriting and fitting pipeline. Any standing text in your saved design, such as a sign-off, is included in the preview.

#Review before sending

Sending tools are marked as actions that spend credits. Your assistant controls when it asks for confirmation; Scribble does not collect a separate approval for each single card. Keep send confirmations on and review the exact address, card, message and cost. A connection without Send handwritten cards cannot send.

#Which assistants work

Where the Scribble MCP server can be connected
AssistantHowNotes
Claude (web, desktop, mobile)Custom connectorStep by step
Claude Codeclaude mcp add --transport httpStep by step
ChatGPTInstall from the app directoryStep by step
Gemini EnterpriseCustom MCP serverStep by step
Gemini CLI / AntigravitymcpServers configStep by step
Microsoft Copilot StudioAdd an MCP toolSame URL, OAuth sign-in
Cursor, Windsurf, ZedmcpServers configSame URL, OAuth sign-in

Anything that speaks Streamable HTTP MCP works. The server implements protocol revisions 2025-03-26 through 2026-07-28, so an older client and a brand-new one both connect to the same URL.

#What it costs

Nothing to connect. Cards cost the same through an assistant as they do anywhere else — one credit each, at your volume rate. Reading contacts, checking credits and looking up a card are all free.

#Common questions

Does the AI write my card for me?
Your assistant can draft the message. Ask it to show you the final words and preview before you approve sending. Scribble writes the message it receives using a machine holding a real pen.
Can the assistant send a card without me seeing it?
It can if send permission is enabled and your assistant's settings allow the call without confirmation. Scribble marks the tool as an action that spends credits, but that marker is not a separate approval step. Keep confirmations on, or untick Send handwritten cards when you connect and use the assistant for drafting only.
Can I see the card before it goes?
Yes. Ask to see it and the assistant draws the inside in the real handwriting and links you to the front it is printed on. That check sends nothing and costs nothing. Every drawing also comes with a web address you can open, which matters if your assistant cannot show pictures in the conversation. The letter shapes are varied on every card, so the one that arrives is in that hand without being that exact drawing.
What if I do not tell it which design to use?
It uses your most recent saved design. If you have not saved any, it does not give up — it can read you our card collection and send one of those, which also files the card in your Designs for next time. Every Scribble card is a greeting card with a printed front; there is no plain stock, so it will always name the card it is about to use.
Can it send me any card on your website?
It can send any active card in the public collection, as well as designs saved in your organization. Ask to see the front before choosing. To use your own artwork, upload it and it joins your private saved designs.
Does Scribble see my conversation?
Our server does not request your conversation history. It receives whatever your assistant includes in its tool calls, such as the recipient, message or contact search. See what an assistant can see.
Can two people connect the same organization?
Yes. Each person's connection is separate, listed under their name in Integrations, and revocable on its own.
How do I disconnect it?
In Scribble, go to Integrations → AI assistants and choose Disconnect. It stops working immediately, including any conversation that is still open.

Last checked against the product on . Something wrong or missing? Tell us.