Use Mail A Letter with Claude and ChatGPT

Last updated: October 6, 2026

Connect your Mail A Letter account to an AI assistant and ask it to mail a letter for you. The assistant starts the letter, you upload the PDF, and the assistant addresses and prices it. Then you check the proof on mailaletter.com and press Send yourself.

An assistant cannot send a letter or spend your balance. Everything it prepares waits as an uncharged draft until you open its review link on mailaletter.com, check exactly what will be printed, and press Send.

Jump to: Claude  |  ChatGPT  |  Mailing a letter  |  Troubleshooting

Before you start

  • A Mail A Letter account. Create one if you don't have one yet, and sign in to mailaletter.com at least once. Connecting an assistant signs you in to an existing account; it does not create one.
  • The sign-in method you use on the website: email and password, Google or Apple. Use the same one when you connect. Signing in with Google or Apple reaches a different account from signing in with an email and password, even when the email address is the same.
  • A complete return address on your Account page. It is printed as the sender on every letter an assistant prepares.
  • Credit in your MailBank to send letters. You can connect and prepare letters without credit, but letters prepared by an assistant are paid for from your MailBank when you press Send.

Every assistant connects to the same server address:

https://mcp.mailaletter.com/mcp

When you connect, Mail A Letter names the app that is connecting and shows what it will be allowed to do: see your letters, where they are in the mail and your balance, and prepare letters as drafts that you review and send yourself. Choose Continue to sign in, sign in to your Mail A Letter account, and you are returned to the assistant.

Connect Claude

claude.ai, Claude Desktop and the Claude mobile app

  1. Open Customize → Connectors.
  2. Find Mail A Letter in the connector directory and choose Connect. If it isn't listed, choose Add custom connector instead, name it Mail A Letter, enter the server address above, and leave the advanced OAuth settings blank.
  3. Confirm the connection and sign in to Mail A Letter.
  4. In a conversation, make sure Mail A Letter is switched on in the tools menu.

On a Claude Team or Enterprise plan, an organization owner adds the connector first; each member then connects with their own Mail A Letter account.

Claude Code

claude mcp add --transport http mailaletter https://mcp.mailaletter.com/mcp

Then run /mcp, choose mailaletter and choose Authenticate. Your browser opens to sign in.

Connect ChatGPT

ChatGPT on the web

  1. Open ChatGPT's Plugins page (chatgpt.com/plugins).
  2. Select the + button, then Add custom MCP server.
  3. Name it Mail A Letter, enter the server address above, and set authentication to OAuth. You don't need a client ID or secret.
  4. Review ChatGPT's warning about custom servers, choose I understand and want to continue, and create it.
  5. Find Mail A Letter in your personal or workspace plugins and choose Install.
  6. Confirm the connection and sign in to Mail A Letter.
  7. In a conversation, type @ in the message box and choose Mail A Letter.

Whether you can add a custom MCP server depends on your ChatGPT plan and workspace. Some accounts must first turn on Developer mode in ChatGPT's settings, and in a Business, Enterprise or Edu workspace an admin may need to add Mail A Letter for everyone. ChatGPT's menus change from time to time; if yours look different, OpenAI's help center has the current steps for adding a custom MCP server.

Codex

codex mcp add mailaletter --url https://mcp.mailaletter.com/mcp
codex mcp login mailaletter

The second command opens your browser to sign in.

Mailing a letter, step by step

  1. Ask your assistant. For example: “Mail my letter to Jane Doe, 500 Union St, Suite 100, Seattle, WA 98101, first class.”
  2. Upload the PDF. The assistant gives you an upload link. Open it, sign in, and upload your PDF. The link is valid for 24 hours, and uploading sends and charges nothing. If the file is rejected, the page tells you why and you can upload a corrected file with the same link. Assistants that can make web requests (Claude Code or Codex, for example) may upload the PDF for you.
  3. The assistant addresses and prices the letter. It tells you the price, the mailing service and what your MailBank balance will be after sending, and gives you a review link.
  4. Review and send. Open the review link and sign in. The page shows the recipient, return address, service, page count and price, with a proof of exactly what will be printed. Press Send to pay from your MailBank and mail the letter. The review link is valid for 24 hours; after that, or if anything about the letter changes, ask the assistant to prepare it again.
  5. Follow it. Ask the assistant where the letter is, at any time.

Things to ask

  • “What's my Mail A Letter balance?”
  • “Send this letter certified mail to my landlord at 12 Oak Ave, Portland, OR 97201.”
  • “Mail this to my grandmother in Phoenix, with a return envelope.”
  • “Which of my letters have been mailed this month?”
  • “What's the tracking number for the letter I sent on Monday?”
  • “Which countries can you mail to, and which services can I use for Germany?”

What an assistant can do

ToolWhat it doesAccess
get_mailing_capabilitiesLists mailing services, the countries you can mail to, letter statuses and limits.Read
get_balanceShows your MailBank balance.Read
list_lettersLists your letters, newest first, with status, recipient name and cost.Read
get_letterShows one letter's status, pages, cost, service, tracking number and review link.Read
get_uploadChecks whether the PDF for a new letter has been uploaded and can be printed.Read
create_upload_linkStarts a new letter and gives you a link to upload its PDF. Sends and charges nothing.Prepare
prepare_letterSets the recipient, service and options, prices the letter and returns a review link. Sends and charges nothing.Prepare

There is no tool to send, pay for or cancel a letter. Those always happen on mailaletter.com, by you. An assistant can only prepare letters it started; letters you start on the website or in the app stay there.

Letter requirements

  • A PDF of up to 20MB and 120 pages.
  • Every page US Letter size (8.5 × 11 in), portrait.
  • Not password protected.
  • A PDF/A file (PDF/A-1a) prints most faithfully, but any regular PDF is accepted.
ServiceDestinations
First Class (default)United States and international
ExpressUnited States and international
TrackedUnited States only
CertifiedUnited States only

You can add a self-addressed return envelope to any letter; it includes postage only for U.S. addresses. Ask your assistant for the full list of countries.

Prices and payment

Prices come from your account's rates at the moment the assistant prepares the letter, including any sales tax, and are shown again on the review page before you send. Preparing a letter never reserves or spends your balance. When you press Send the letter is paid from your MailBank; if your balance is short, the review page tells you by how much, so you can add credit and come back to send.

Letter statuses and canceling

StatusMeaning
draftPrepared but not sent; nothing has been charged.
processingPayment is being processed.
in_productionPaid and queued for printing.
printedPrinting has started or finished; the letter can no longer be canceled.
mailedHanded to the postal service. This is not confirmation of delivery.
canceledCanceled before printing; any charge was refunded to your MailBank.
erroredThe letter could not be processed; our support team will follow up.

An assistant cannot cancel a letter. To cancel one you have sent, open your Mailbox on mailaletter.com: a letter can be canceled for up to 6 hours after you send it, as long as printing has not started, and the full amount goes back to your MailBank as credit. Closing a conversation does not cancel a letter you have already sent.

Limits

To protect your account, assistants can start up to 20 new letters a day and prepare letters up to 20 times a day (preparing the same letter again counts), and you can have up to 50 unsent assistant letters at once. These limits are shared by all the assistants you connect. Your assistant tells you if you reach a limit and what to do next.

Your data

An assistant sees only what the tools return: your MailBank balance and, for your letters, their status, recipient name, service, page count, cost and tracking number. The letter list does not include addresses or letter contents. The recipient details you give an assistant are stored with the letter, as they are for any letter you create on mailaletter.com, and handled under our Privacy Statement. What you type and attach in a conversation is handled by the assistant's provider (Anthropic for Claude, OpenAI for ChatGPT and Codex) under its own privacy policy.

Disconnecting

  • Claude: open Customize → Connectors and disconnect or remove Mail A Letter. In Claude Code, run claude mcp remove mailaletter.
  • ChatGPT: open Mail A Letter on ChatGPT's Plugins page and remove it. In Codex, run codex mcp remove mailaletter.

A connection that goes unused for 90 days ends automatically. Disconnecting doesn't affect letters you have already sent or drafts an assistant prepared; those stay in your Mailbox. If you think an assistant was connected to your account without your permission, email support@mailaletter.com.

Troubleshooting

ProblemWhat to do
The assistant says your account isn't linkedSign in once at mailaletter.com with the same sign-in method you used when connecting, then try again.
ChatGPT has no option to add a custom MCP serverTurn on Developer mode in ChatGPT's settings, or ask your workspace admin to add Mail A Letter.
The assistant says a return address is requiredComplete your return address on the Account page, then ask the assistant to prepare the letter again.
The upload page rejected your PDFThe page says why (for example, a page that isn't US Letter size). Fix the file and upload it again with the same link.
The upload link has expiredUpload links last 24 hours. Ask the assistant to start the letter again.
The review page says the review has expiredAsk the assistant to prepare the letter again; it gives you a new review link.
The Send button is disabledCheck the message on the review page. If your MailBank balance is short, add credit and come back to send. If sending is temporarily paused, your draft is saved; try again later.

Questions? Email support@mailaletter.com.