Integration · Email

Connect Claude & ChatGPT to Mailrith

Ask your AI how last month's emails performed, or to add a new subscriber and tag them. It can search subscribers, tags, segments, forms, sequences, automations and broadcasts, and build email reports for a date range. It can also draft a broadcast, send a test, run the pre-send check and send or schedule it, with your approval if you want it.

Connect Mailrith free

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

Try asking

“How did our emails perform last month, day by day?”
The AI builds an email report for the date range, grouped by day, with sends, opens and clicks.
“Add [email protected] as a subscriber and tag her webinar.”
It creates the subscriber, finds the webinar tag and adds it. Making her Active requires consent evidence.
“Draft a broadcast about our October sale, based on last month's newsletter.”
It reads the earlier broadcast and creates a new draft with subject and content. Nothing is sent yet.

What your AI can do

Subscribers and tags

Search, create and update subscribers, change their status, add or remove tags, and delete subscribers.

Broadcasts

Create and edit draft broadcasts, send tests, run the pre-send check, and send or schedule them and follow the progress.

Sequences, automations and reports

Read sequences, automations, segments and form submissions, add or remove subscribers in sequences, and build email reports.

“Send me a test of that broadcast.”
It sends a test copy of the broadcast to your email address.
“Check the broadcast and schedule it for Tuesday at 9:00 CET.”
It runs the pre-send check, shows problems and the estimated recipients, and schedules it for that time.
“Take [email protected] out of the onboarding sequence.”
It finds the subscriber and removes him from the sequence, so he gets no more of its emails.

125 tools for Mailrith

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

add_subscriber_to_sequenceChanges dataEnroll a subscriber (`subscriber_id`) in an email sequence (`sequence_id`); they will start receiving its emails.
add_tag_to_subscriberChanges dataAdd a tag (`tag_id`) to a subscriber (`subscriber_id`). This can trigger automations.
cancel_broadcastDeletesCancel a broadcast (broadcast id). Destructive action; may require approval. API summary: Cancel a broadcast send.
check_broadcastRun the pre-send check on a broadcast (`broadcast_id`): shows problems and the estimated number of recipients.
create_a_subscriber_export_jobChanges dataCreate a new project. API summary: Create a subscriber export job.
create_an_email_templateVisible to othersEmail a message. Has effects visible outside this system. API summary: Create an email template.
create_automationChanges dataCreate a new automation. Required: name or definition. Search automations first to avoid duplicates. API summary: Create an automation.
create_automation_testChanges dataCreate a new test for a automation. Required: recipient or subscriber id. API summary: Send automation test messages.
create_broadcastVisible to othersCreate a draft broadcast with a `subject` and `body_document` (Mailrith's email document; copy the structure from an existing broadcast), plus optional `preview_text` and `audience_definition`. Nothing is sent until it is scheduled or sent.
create_custom_fieldChanges dataCreate a new custom field. Required: label or type. Search custom fields first to avoid duplicates. API summary: Create a custom field.
create_documentChanges dataCreate a new document. API summary: Start a subscriber import upload.
create_email_delivery_connection_setup_session_renewVisible to othersCreate a new renew for a email delivery connection setup session. Has effects visible outside this system. API summary: Renew secure email delivery setup.
create_email_reportChanges dataBuild an email performance report (sends, opens, clicks and so on) for a date range `from`-`to` (YYYY-MM-DD), optionally grouped by `group_by` (source_type, source, message, provider, day) and limited to `source_types` or `source_ids`.
create_formChanges dataCreate a new form. Required: name. Search forms first to avoid duplicates. API summary: Create a form.
create_form_double_opt_in_previewChanges dataCreate a new double opt in preview for a form. Required: subscriber id. API summary: Preview a form confirmation email for a Subscriber.
create_magic_linkChanges dataCreate a new magic link. Required: name or target type. Search magic links first to avoid duplicates. API summary: Create a magic link.
create_pageChanges dataCreate a new page. Required: name or slug. Search pages first to avoid duplicates. API summary: Create a landing page.
create_page_double_opt_in_previewChanges dataCreate a new double opt in preview for a page. Required: subscriber id. API summary: Preview a landing page confirmation email for a Subscriber.
create_projectChanges dataCreate a new project. Required: upload id or mappings. API summary: Create a subscriber import job.
create_segmentChanges dataCreate a new segment. Required: name or definition. Search segments first to avoid duplicates. API summary: Create a segment.
create_sequenceChanges dataCreate a new sequence. Required: name or definition. Search sequences first to avoid duplicates. API summary: Create a sequence.
create_sequence_testChanges dataCreate a new test for a sequence. Required: recipient or subscriber id. API summary: Send sequence test messages.
create_shipmentVisible to othersCreate a new shipment for a shipment. Required: to. Has effects visible outside this system. API summary: Send an email delivery connection test.
create_subscriberChanges dataAdd a subscriber with `email` and optional `name`, `country`, `status` and `custom_fields`. Making someone Active requires `consent_evidence` (lawful basis, when and where consent was collected).
create_subscriptionDeletesCreate a new subscription. Required: name, url or event patterns. Destructive action; may require approval. API summary: Create a webhook subscription.
create_subscription_rotate_secretDeletesCreate a new rotate secret for a subscription. Destructive action; may require approval. API summary: Rotate a webhook signing secret.
create_tagChanges dataCreate a tag with a `name` and optional `description`.
delete_automationDeletesPermanently delete a automation by automation id. Destructive action; may require approval. API summary: Delete an automation.
delete_broadcastDeletesPermanently delete a broadcast by broadcast id. Destructive action; may require approval.
delete_broadcast_schedulesMoves moneyPermanently delete a schedule by broadcast id. Financial or irreversible action; may require approval. API summary: Unschedule a broadcast.
delete_custom_fieldDeletesPermanently delete a custom field by custom field id. Destructive action; may require approval.
delete_formDeletesPermanently delete a form by form id. Destructive action; may require approval.
delete_magic_linkDeletesPermanently delete a magic link by magic link id. Destructive action; may require approval.
delete_messageDeletesPermanently delete a message by template id. Destructive action; may require approval. API summary: Delete an email template.
delete_pageDeletesPermanently delete a page by page id. Destructive action; may require approval. API summary: Delete a landing page.
delete_segmentDeletesPermanently delete a segment by segment id. Destructive action; may require approval.
delete_sequenceDeletesPermanently delete a sequence by sequence id. Destructive action; may require approval.
delete_shipmentDeletesPermanently delete a shipment by connection id. Destructive action; may require approval. API summary: Delete an email delivery connection.
delete_subscriberDeletesPermanently delete a subscriber by `subscriber_id`. This cannot be undone.
delete_subscriptionDeletesPermanently delete a subscription by subscription id. Destructive action; may require approval. API summary: Delete a webhook subscription.
delete_tagDeletesPermanently delete a tag by tag id. Destructive action; may require approval.
get_a_formGet one form by form id. API summary: Get a form.
get_a_landing_pageGet one page by page id. API summary: Get a landing page.
get_a_subscriber_export_jobGet one project by job id. API summary: Get a subscriber export job.
get_an_email_templateGet one message by template id. API summary: Get an email template.
get_automationGet one automation by `automation_id`, with its trigger and steps.
get_automation_runGet one run for a automation by run id. API summary: Get Automation run diagnostics.
get_automation_statusChanges dataGet the current status of a automation by automation id. API summary: Change an automation status.
get_broadcastGet one broadcast by `broadcast_id`, including subject, content, audience and schedule.
get_broadcast_2Get one broadcast by broadcast id. API summary: Get Broadcast diagnostics.
get_broadcast_progressGet sending progress of a broadcast (`broadcast_id`).
get_custom_fieldGet one custom field by custom field id. API summary: Get a custom field.
get_documentGet one document by upload id. API summary: Get a subscriber import upload.
get_email_delivery_connection_setup_sessionGet one email delivery connection setup session by setup session id. API summary: Get secure setup status.
get_formGet one form by starting point id. API summary: Get a Form starting point.
get_form_submissionGet one submission for a form by submission id. API summary: Get a form submission.
get_magic_linkGet one magic link by magic link id. API summary: Get a magic link.
get_messageGet one message by starting point id. API summary: Get an email starting point.
get_pageGet one page by starting point id. API summary: Get a Landing Page starting point.
get_page_submissionGet one submission for a page by submission id. API summary: Get a landing page submission.
get_projectGet one project by job id. API summary: Get a subscriber import job.
get_reportGet one report by report id. Results are paginated. API summary: Get an analytics report.
get_segmentGet one segment by segment id. API summary: Get a segment.
get_sender_identityGet one sender identity by sender identity id. API summary: Get a sender identity.
get_sequenceGet one sequence by `sequence_id`, with its emails and settings.
get_sequence_2Get one sequence by sequence id. Results are paginated. API summary: Get Sequence diagnostics.
get_sequence_statusChanges dataGet the current status of a sequence by sequence id. API summary: Activate or pause a sequence.
get_shipmentGet one shipment by connection id. API summary: Get an email delivery connection.
get_shipment_statusVisible to othersGet the current status of a shipment by connection id. Has effects visible outside this system. API summary: Enable or disable an email delivery connection.
get_subscriberGet one subscriber by `subscriber_id`, with status, custom fields, tags and sequences.
get_subscriber_2Get one subscriber by subscriber id. API summary: Get privacy-conscious Subscriber diagnostics.
get_subscriptionGet one subscription by subscription id. API summary: Get a webhook subscription.
get_tagGet one tag by tag id. API summary: Get a tag.
get_workspaceGet the Mailrith workspace this connection belongs to.
list_automation_journey_previewsList journey previews for a automation. Optional filters: subscriber id. API summary: Preview an automation journey.
list_automation_preflightsList preflights for a automation. API summary: Check automation readiness.
list_automation_runsList runs for a automation. Results are paginated. API summary: List Automation run diagnostics.
list_broadcast_delivery_errorsList delivery errors for a broadcast. Results are paginated. API summary: List broadcast delivery errors.
list_capabilitiesList capabilities. API summary: Get authenticated API capabilities.
list_form_submissionsList submissions to a signup form (`form_id`).
list_formsList forms. API summary: List Form starting points.
list_page_submissionsList submissions for a page. Results are paginated. API summary: List landing page submissions.
list_pagesList pages. API summary: List Landing Page starting points.
list_projectsList projects. Results are paginated. API summary: List subscriber import jobs.
list_sender_identitiesList sender identities. Results are paginated.
list_sequence_journey_previewsList journey previews for a sequence. Optional filters: subscriber id. API summary: Preview a sequence journey.
list_sequence_preflightsList preflights for a sequence. API summary: Check sequence readiness.
list_subscriber_export_jobsList projects. Results are paginated. API summary: List subscriber export jobs.
list_subscriptionsList subscriptions. API summary: List webhook subscriptions.
remove_subscriber_from_sequenceDeletesTake a subscriber (`subscriber_id`) out of a sequence (`sequence_id`) so they receive no more of its emails.
remove_tag_from_subscriberDeletesRemove a tag (`tag_id`) from a subscriber (`subscriber_id`).
schedule_broadcastDeletesSchedule a broadcast (`broadcast_id`) to go out at `scheduled_at` (future date-time with time zone). It will then email the whole audience.
search_automationsList or search automations.
search_broadcastsList or search broadcasts (one-off email campaigns).
search_custom_fieldsSearch custom fields by search. Use this to find existing custom fields before creating a new custom field. Results are paginated. API summary: List custom fields.
search_formsList or search signup forms.
search_magic_linksSearch magic links by search. Use this to find existing magic links before creating a new magic link. Results are paginated. API summary: List magic links.
search_pagesSearch pages by search. Use this to find existing pages before creating a new page. Results are paginated. API summary: List landing pages.
search_segmentsList or search saved subscriber segments.
search_sequencesList or search email sequences (drip series).
search_subscribersSearch subscribers by exact `email`, free-text `search`, `status`, `tag_id`/`tag_ids` or `sequence_id`/`sequence_ids`. Paginate with `cursor`.
search_tagsList or search tags by name.
send_broadcastVisible to othersSend a broadcast (`broadcast_id`) to its audience now. This emails real subscribers and cannot be undone; run check_broadcast first.
send_delivery_connectionVisible to othersEmail a delivery connection. Has effects visible outside this system. Results are paginated. API summary: List email delivery connections.
send_messageVisible to othersEmail a message. Has effects visible outside this system. Results are paginated. API summary: List email templates.
send_shipmentVisible to othersEmail a shipment. Has effects visible outside this system. API summary: Start secure email delivery connection setup.
send_starting_point_templatesVisible to othersEmail a starting point. Has effects visible outside this system. API summary: List email starting points.
send_test_broadcastVisible to othersSend a test copy of a broadcast to one `recipient` email address, personalized as `subscriber_id`.
set_subscriber_statusChanges dataChange a subscriber's `status` (e.g. Unsubscribed or Active). Setting Active requires `consent_evidence`.
submit_messageVisible to othersPreview a message (template id). Has effects visible outside this system. API summary: Preview an email template for a Subscriber.
submit_segmentVisible to othersPreview a segment. Has effects visible outside this system. API summary: Preview a segment definition.
submit_shipmentVisible to othersVerify a shipment (connection id). Has effects visible outside this system. API summary: Verify an email delivery connection.
update_automationChanges dataUpdate an existing automation identified by automation id. API summary: Update an automation.
update_broadcastVisible to othersEdit a draft broadcast by `broadcast_id`: subject, preview text, body or audience.
update_custom_fieldChanges dataUpdate an existing custom field identified by custom field id. API summary: Update a custom field.
update_formChanges dataUpdate an existing form identified by form id. API summary: Update a form.
update_magic_linkChanges dataUpdate an existing magic link identified by magic link id. API summary: Update a magic link.
update_messageVisible to othersUpdate an existing message identified by template id. Has effects visible outside this system. API summary: Update an email template.
update_pageChanges dataUpdate an existing page identified by page id. API summary: Update a landing page.
update_segmentChanges dataUpdate an existing segment identified by segment id. API summary: Update a segment.
update_sequenceChanges dataUpdate an existing sequence identified by sequence id. API summary: Update a sequence.
update_shipmentVisible to othersUpdate an existing shipment identified by connection id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update an email delivery connection.
update_subscriberChanges dataUpdate a subscriber's name, email, country or custom fields by `subscriber_id`.
update_subscriptionDeletesUpdate an existing subscription identified by subscription id. Destructive action; may require approval. API summary: Update a webhook subscription.
update_tagChanges dataUpdate an existing tag identified by tag id. API summary: Update a tag.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Mailrith from the app list.
2
Paste your key
Paste a Mailrith workspace API key. In Mailrith, pick the workspace in the left sidebar and click Settings > API Keys > Generate API Key. Choose Workspace, a name, a Work Profile (Full Email Marketing Access or a narrower one) and an expiration. Copy the secret, as it is shown only once.
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 Mailrith?

The AI can search and read subscribers, tags, segments, forms and form submissions, sequences, automations and broadcasts, and build email reports. It can create and update subscribers and tags, change a subscriber's status, manage tags and sequence enrollment, delete subscribers, and create, test, send and schedule broadcasts.

Does the AI see my Mailrith credentials?

No. Your Mailrith API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with reports and lookups. Sending or scheduling a broadcast emails real subscribers, and deleting a subscriber cannot be undone. These actions can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then 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 with no credit card required. Paid plans bill per completed task. You also need your own Mailrith account.

Why does the AI ask for consent evidence?

Mailrith requires consent evidence to make a subscriber Active: the lawful basis, and when and where consent was collected. The AI passes it when it creates an Active subscriber or sets someone to Active, so tell it where and when the person signed up.