Integration · Email

Connect Claude & ChatGPT to Direct Mail

Ask your AI how your last Direct Mail campaign did, who clicked a link, or to add a new contact to a mailing list. It can manage address groups and contacts, write and edit message drafts, and read reports for sent messages with recipients, opens and clicks. Sending stays in the Direct Mail app.

Connect Direct Mail free

Free plan, no credit card. Takes about a minute.

Try asking

“How did last week's newsletter do?”
The AI finds the report for the sent message and reads its delivery, open and click statistics.
“Who clicked the pricing link in the September newsletter?”
It lists the links in that report and the recipients who clicked the one you mean.
“Add [email protected] to the Customers list with her name and company.”
It checks whether she is already in the address group, then adds her with the fields you give.

What your AI can do

Address groups and contacts

List and create address groups, and find, add, update, unsubscribe or remove contacts with names, company and custom fields.

Message drafts

List and read messages, and create or edit drafts with subject, sender and HTML or plain text content.

Reports

Read reports for sent messages with delivery, open and click statistics, plus recipients, opens, links and link clicks.

“Mark [email protected] as unsubscribed.”
It finds the contact in the address group and marks it as unsubscribed.
“Draft an HTML email announcing our new opening hours.”
It creates a message draft with subject, sender and HTML content in your project. It is not sent.
“Create a new address group called Webinar attendees.”
It creates the address group in the project you pick.

49 tools for Direct Mail

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_addressChanges dataAdd a contact to an address group: `email`, first and last name, company and custom fields; needs `project_id` and `address_group_id`.
create_address_groupChanges dataCreate a new address group (mailing list) in a project; needs `project_id` and `name`.
create_messageChanges dataCreate a new email message draft in a project: `content_type` (text/plain or text/html), `subject`, sender name and email, and HTML or text content. It is not sent.
create_message_headerVisible to othersCreate a new header for a message. Required: field or value. Has effects visible outside this system. API summary: /projects/:documentidentifier/messages/:messageuuid/headers.
create_project_webhookDeletesCreate a new webhook for a project. Required: events or url. Destructive action; may require approval. API summary: /projects/:documentidentifier/webhooks.
create_webhooksChanges dataCreate a new t3e7ejt3. API summary: Webhooks.
delete_addressDeletesPermanently remove one contact from an address group by `address_id` (with `project_id` and `address_group_id`). This cannot be undone.
delete_address_group_addressesMoves moneyPermanently delete a address by address group id. Financial or irreversible action; may require approval. API summary: /projects/:documentidentifier/address-groups/:addressgroupuuid/addresses.
delete_message_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: /projects/:documentidentifier/messages/:messageuuid/attachments/:attachmentuuid.
delete_message_headerDeletesPermanently delete a header by header id. Destructive action; may require approval. API summary: /projects/:documentidentifier/messages/:messageuuid/headers/:headeruuid.
delete_project_address_groupDeletesPermanently delete a address group by address group id. Destructive action; may require approval. API summary: /projects/:documentidentifier/address-groups/:addressgroupuuid.
delete_project_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: /projects/:documentidentifier/messages/:messageuuid.
delete_project_reportDeletesPermanently delete a report by report id. Destructive action; may require approval. API summary: /projects/:documentidentifier/reports/:reportuuid.
delete_project_webhookDeletesPermanently delete a webhook by webhook id. Destructive action; may require approval. API summary: /projects/:documentidentifier/webhooks/:webhookuuid.
delete_recipient_addressesMoves moneyPermanently delete a address by recipient id. Financial or irreversible action; may require approval. API summary: /projects/:documentidentifier/reports/:reportuuid/recipients/:recipientuuid/live-address.
get_addressGet one contact by `project_id`, `address_group_id` and `address_id`.
get_address_groupGet one address group by `project_id` and `address_group_id`.
get_messageGet one message's subject, sender and content by `project_id` and `message_id`.
get_message_documentGet one document for a message by document id. API summary: /projects/:documentidentifier/messages/:messageuuid/attachments/:attachmentuuid.
get_message_headerGet one header for a message by header id. API summary: /projects/:documentidentifier/messages/:messageuuid/headers/:headeruuid.
get_projectGet one project's details by `project_id`.
get_project_webhookGet one webhook for a project by webhook id. API summary: /projects/:documentidentifier/webhooks/:webhookuuid.
get_reportGet one sent-message report with its delivery, open and click statistics by `project_id` and `report_id`.
get_report_linkGet one link for a report by link id. API summary: /projects/:documentidentifier/reports/:reportuuid/links/:linkuuid.
get_report_recipientGet one recipient's delivery details in a report by `project_id`, `report_id` and `recipient_id`.
list_address_groupsList the address groups (mailing lists) in a project by `project_id`.
list_addressesList the contacts in an address group, or find one by `email`; needs `project_id` and `address_group_id`. Search before adding to avoid duplicates.
list_link_clicksList who clicked one link in a sent message, by `project_id`, `report_id` and `link_id`.
list_message_documentsList documents for a message. API summary: /projects/:documentidentifier/messages/:messageuuid/attachments.
list_message_headersList headers for a message. API summary: /projects/:documentidentifier/messages/:messageuuid/headers.
list_messagesList the email messages (campaign drafts) in a project by `project_id`.
list_project_webhooksList webhooks for a project. API summary: /projects/:documentidentifier/webhooks.
list_projectsList the Direct Mail projects this API key can access, with their IDs. Use this first to get a `project_id`.
list_recipient_addressesList addresses for a recipient. API summary: /projects/:documentidentifier/reports/:reportuuid/recipients/:recipientuuid/archived-address.
list_recipient_addresses_getList addresses for a recipient. API summary: /projects/:documentidentifier/reports/:reportuuid/recipients/:recipientuuid/live-address.
list_recipient_clicksList the links one recipient clicked in a sent message, by `project_id`, `report_id` and `recipient_id`.
list_recipient_opensList when one recipient opened a sent message, by `project_id`, `report_id` and `recipient_id`.
list_report_linksList the links in a sent message with their click counts, by `project_id` and `report_id`.
list_report_messagesList messages for a report. API summary: /projects/:documentidentifier/reports/:reportuuid/message.
list_report_recipientsList the recipients of a sent message by `project_id` and `report_id`.
list_reportsList the reports for sent messages in a project by `project_id`.
update_addressChanges dataUpdate a contact by `address_id` (with `project_id` and `address_group_id`): name, email, company, custom fields, or mark as unsubscribed. Only the fields you pass change.
update_address_group_addressesVisible to othersUpdate an existing address identified by address group id. Only the fields you pass are changed. Has effects visible outside this system. API summary: /projects/:documentidentifier/address-groups/:addressgroupuuid/addresses.
update_messageVisible to othersEdit a message draft's subject, sender, title or content by `project_id` and `message_id`. Only the fields you pass change.
update_message_headerVisible to othersUpdate an existing header identified by header id. Only the fields you pass are changed. Has effects visible outside this system. API summary: /projects/:documentidentifier/messages/:messageuuid/headers/:headeruuid.
update_projectChanges dataUpdate an existing project identified by project id. Only the fields you pass are changed. API summary: /projects/:documentidentifier.
update_project_address_groupChanges dataUpdate an existing address group identified by address group id. Only the fields you pass are changed. API summary: /projects/:documentidentifier/address-groups/:addressgroupuuid.
update_project_reportChanges dataUpdate an existing report identified by report id. Only the fields you pass are changed. API summary: /projects/:documentidentifier/reports/:reportuuid.
update_recipient_addressesVisible to othersUpdate an existing address identified by recipient id. Only the fields you pass are changed. Has effects visible outside this system. API summary: /projects/:documentidentifier/reports/:reportuuid/recipients/:recipientuuid/live-address.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Direct Mail from the app list.
2
Paste your key
Paste your Direct Mail API Key ID and Key Secret, and the project document identifier. In the Direct Mail Mac app choose Direct Mail > Direct Mail Account, scroll to API Access, click Show and then Add New API Key. Then open your project, click Collaboration in the sidebar, click + > Add API Key, select the key and save. The project must be saved in the cloud, and its API Document Identifier is shown at the bottom of the Collaboration window.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Direct Mail?

It can list and read your projects, address groups, contacts, messages and reports for sent messages, including recipients, opens, links and clicks. It can create address groups, add, update and remove contacts, and create and edit message drafts.

Does the AI see my Direct Mail API key?

No. You paste your Direct Mail Key ID and Key Secret into HeyMyApps once. They are encrypted at rest, never shown to the AI and never shown again after you save them. The AI only gets the results of the tools you have switched on.

Can I control what the AI is allowed to do?

Yes. Switch on only the tools you want, for example reports and contact lookups without changes. Actions that cannot be undone, like delete_address, can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan, and you do not need a credit card to start. Paid plans are billed per completed task. You also need your own Direct Mail account.

Can the AI send campaigns?

No. The AI can create and edit message drafts, but there is no tool for sending. You review and send the message yourself in the Direct Mail app, and the AI can then read the report.