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
- Open Customize → Connectors.
-
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.
- Confirm the connection and sign in to Mail A Letter.
- 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
- Open ChatGPT's Plugins page (chatgpt.com/plugins).
- Select the + button, then Add custom MCP server.
-
Name it Mail A Letter, enter the server address above, and set authentication to
OAuth. You don't need a client ID or secret.
-
Review ChatGPT's warning about custom servers, choose
I understand and want to continue, and create it.
- Find Mail A Letter in your personal or workspace plugins and choose Install.
- Confirm the connection and sign in to Mail A Letter.
- 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
-
Ask your assistant. For example: “Mail my letter to Jane Doe, 500 Union St,
Suite 100, Seattle, WA 98101, first class.”
-
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.
-
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.
-
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.
-
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
| Tool | What it does | Access |
get_mailing_capabilities | Lists mailing services, the countries you can mail to, letter statuses and limits. | Read |
get_balance | Shows your MailBank balance. | Read |
list_letters | Lists your letters, newest first, with status, recipient name and cost. | Read |
get_letter | Shows one letter's status, pages, cost, service, tracking number and review link. | Read |
get_upload | Checks whether the PDF for a new letter has been uploaded and can be printed. | Read |
create_upload_link | Starts a new letter and gives you a link to upload its PDF. Sends and charges nothing. | Prepare |
prepare_letter | Sets 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.
| Service | Destinations |
| First Class (default) | United States and international |
| Express | United States and international |
| Tracked | United States only |
| Certified | United 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
| Status | Meaning |
draft | Prepared but not sent; nothing has been charged. |
processing | Payment is being processed. |
in_production | Paid and queued for printing. |
printed | Printing has started or finished; the letter can no longer be canceled. |
mailed | Handed to the postal service. This is not confirmation of delivery. |
canceled | Canceled before printing; any charge was refunded to your MailBank. |
errored | The 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
| Problem | What to do |
| The assistant says your account isn't linked | Sign 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 server | Turn on Developer mode in ChatGPT's settings, or ask your workspace admin to add Mail A Letter. |
| The assistant says a return address is required | Complete your return address on the Account page, then ask the assistant to prepare the letter again. |
| The upload page rejected your PDF | The 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 expired | Upload links last 24 hours. Ask the assistant to start the letter again. |
| The review page says the review has expired | Ask the assistant to prepare the letter again; it gives you a new review link. |
| The Send button is disabled | Check 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.