How to connect MailUp to Claude

Connect Claude Web, Desktop and Cowork to MailUp MCP. List recent mailup campaigns by engagement, add recipients to a mailup subscriber list, and more using natural language, with authentication handled for you.

MailUp logoMailUp
Oauth2

MailUp is an email and SMS marketing platform for managing contacts, campaigns, and engagement data. It helps teams run targeted marketing campaigns and track performance from one place.

151 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your MailUp account to Claude via Composio Connect, enabling it to list recent MailUp campaigns by engagement, add recipients to a MailUp subscriber list, review MailUp SMS delivery statistics, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate MailUp with

Connecting MailUp to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your MailUp account

Back in Claude, ask it to connect to MailUp or give it any MailUp-related task.

For example, ask Claude to:

  • "List recent MailUp campaigns by engagement"
  • "Add recipients to a MailUp subscriber list"
  • "Review MailUp SMS delivery statistics"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your MailUp account is ready to use.

What is the MailUp Claude Connector, and what's possible with it?

The MailUp MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your MailUp account. It provides structured and secure access to your email and SMS marketing lists, recipients, groups, drafts, content, and engagement counts, so your agent can create campaigns, manage subscribers, organize audiences, and review campaign metrics on your behalf.

  • Email and SMS campaign drafts: Have your agent create email or SMS drafts, copy existing email messages, start messages from templates, and remove drafts you no longer need.
  • Audience and subscriber management: Direct your agent to create mailing lists and audience groups, add or update SMS recipients, count subscribers, unsubscribe groups of recipients, or remove recipients from a list.
  • Campaign content and organization: Let the agent upload or delete campaign images, add or remove email attachments, and create or delete tags for organizing email messages.
  • Personalization and tracking controls: Instruct your agent to enable or disable dynamic recipient fields, configure email tracking for recipients across lists, and connect personalization services to mailing lists.
  • Campaign performance checks: Have your agent count the recipients associated with an email message and report how many subscribers belong to a list or audience group.

Troubleshooting

1. Why does Claude not use the Composio connector for MailUp?

The connector can show as connected, but Claude must use it in each MailUp conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to MailUp again.

2. Why does Claude show an MCP server error before MailUp connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for MailUp.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect MailUp.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the MailUp authorization link not work?

The Composio connector is one server. Your MailUp account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the MailUp connection.
  • Composio creates a fresh MailUp authorization link.
  • Open that link in your browser and finish the MailUp sign-in.

4. Why do MailUp actions fail after they worked before?

The MailUp connection can expire or lose permission.

  • Ask Claude to inspect the MailUp connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the MailUp account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in MailUp.
  • If the action still fails with a permission error, check that the connected account has that permission in MailUp itself.

5. How do I switch to a different MailUp account?

Claude can manage the MailUp connection for you.

  • Ask Claude to disconnect or delete the current MailUp account.
  • Ask Claude to connect MailUp again.
  • Open the new Composio authorization link for MailUp.
  • Sign in with the other MailUp account in the browser.
  • After the account connects, ask Claude to retry the MailUp task.

6. Why is my MailUp connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your MailUp connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If MailUp tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect MailUp.
TOOLS

Supported Tools

Every MailUp action and event your agent gets out of the box.

Add Image

Decode and store supplied base64 image data in either MailUp's shared console library or one list, returning the resulting full paths.

Add Message Attachment

Upload base64-encoded bytes into a specific attachment slot on one MailUp email message.

Associate Personalization Endpoint With List

Associate an existing MailUp personalization endpoint with one list.

Import SMS Recipients To Group

Asynchronously add or update an SMS recipient batch in a MailUp group and return the import ID.

Import SMS Recipients To List

Asynchronously add or update an SMS recipient batch in a MailUp list and return the import ID.

Import One SMS Recipient To Group

Add or update one SMS recipient in a MailUp group and return the recipient ID.

Import One SMS Recipient To List

Add or update one SMS recipient in a MailUp list and return the recipient ID.

Batch Unsubscribe Recipients From List

Remove multiple recipients' memberships from one MailUp list without deleting their global recipient records.

Confirm SMS Numeric Sender

Confirm a MailUp numeric SMS sender using the code previously delivered by the sender-confirmation flow.

Copy Email Message

Create a copy of one MailUp email message, optionally replacing its subject or internal notes; this does not send it.

Count Message Sending Recipients

Return MailUp's count of recipients to whom one email message was sent.

Count Subscribers

Return the subscribed-recipient count for a MailUp list or, when group_id is supplied, for one group in that list.

Create Audience Group

Create a recipient group in one MailUp list and return the complete group record.

Create Content Source

Create a named content-provider source in MailUp.

Create Email Message

Create a draft email campaign message in one MailUp list without sending it.

Create Email Message from Template

Create a new draft email message in a MailUp list from an existing template without sending it.

Create List

Create a MailUp mailing list without adding recipients or sending messages.

Create Personalization Endpoint

Create a MailUp endpoint used to obtain external personalization data.

Create SMS Message

Create a MailUp SMS draft without sending or consuming delivery credits.

Create SMTP+ Account

Create an SMTP+ user account for a MailUp list and return its generated credentials.

Create Tag

Create a named tag in one MailUp list for organizing email messages.

Delete Audience Group

Permanently delete one MailUp group.

Delete Audience Recipient From List

Delete one recipient record from one MailUp list only; other list memberships are unaffected.

Delete Audience Recipient Globally

Permanently delete one MailUp recipient from every list in the account.

Delete Content Source

Permanently delete one MailUp content-provider source.

Delete Email Message

Permanently delete one MailUp email message from a list.

Delete Image

Permanently delete the image at an exact full MailUp path from provider storage.

Delete List

Permanently delete one MailUp list and its list-scoped configuration.

Delete Message Attachment

Permanently remove the attachment in one slot from a MailUp email message and return the remaining attachments.

Delete Personalization Endpoint

Permanently delete one MailUp personalization endpoint.

Delete Email Sending Task

Delete an existing MailUp email sending task record; this does not recall email already delivered.

Delete SMS Message

Permanently delete one MailUp SMS draft without sending it.

Delete Source Content

Permanently delete one keyed content item from a MailUp content-provider source.

Delete Tag

Permanently delete one tag from a MailUp list; messages using it may lose that classification.

Disable Trusted Sender

Disable a trusted sender registration by ID so it is no longer active for sending.

Disassociate Personalization Endpoint From List

Remove one MailUp personalization endpoint association from a list.

Empty Audience Group

Remove every recipient membership from one MailUp group.

Set Email Message Dynamic Fields

Enable or disable dynamic recipient-field substitution on one MailUp email message and return its complete current details.

Set SMS Message Dynamic Fields

Explicitly enable or disable dynamic recipient-field substitution for one MailUp SMS draft.

Set Tracking for Every List

Explicitly enable or disable email tracking for one recipient across every MailUp list.

Set Tracking for List

Explicitly enable or disable email tracking for one recipient on one MailUp list.

Find Recipients

Find MailUp recipients by email address, mobile number, or both; this endpoint cannot list recipients without a lookup value.

Get Account Details

Return the connected MailUp account identity, plan, trial status, expiry, and available credits; use this before credit-dependent sending.

Get Account Info

Return the authenticated MailUp account identity, console version, trial flag, and optional expiry/URL.

List Archived Email Messages

Return one page of archived email messages from a specific MailUp list.

Get Deferred Dispatch Date

Get the first useful MailUp date for scheduling a sending task.

Get Earliest Deferred SMS Dispatch Date

Return MailUp's earliest useful scheduling date for one SMS sending task.

List Deferred SMS Sendings

Return SMS sending tasks scheduled for deferred dispatch.

Get Email Message

Return the content, subject, tracking settings, tags, dynamic fields, and attachments for one MailUp email message.

List Email Send History for List

Return one page of send-history records across all email messages in one MailUp list.

Get Email Template Details

Return metadata and content for one email template in a MailUp list.

List Email Templates

Return one page of email templates defined in a specific MailUp list.

List Immediate SMS Sendings

Return SMS sending tasks scheduled for immediate dispatch.

Get Import Details

Return the complete MailUp import configuration and nested valid/invalid row totals for one import ID.

Get Import Sending

Return the sending and message IDs for confirmation requests generated by one MailUp import.

Get Import Status

Return completion and recipient outcome counts for an asynchronous MailUp import ID.

List Last Sent SMS Messages

Return the most recently sent SMS messages and their account-billing costs for one list.

Get List

Return configuration and sender details for one MailUp mailing list by ID.

Get MailUp Login URL

Create an ephemeral URL that logs a user into the MailUp platform.

List Current User Email Messages

Return one page of cloned and original email messages across lists for the current MailUp user.

List Message Attachments

Return all attachment slots currently configured on one MailUp email message.

Get Message Statistics

Return aggregate recipient, view, click, bounce, and unsubscription counts for one MailUp email message using five read-only statistics calls.

Get Message Statistics Pages

Return MailUp's precompiled public statistics-page URLs for one message: overall, click trend, opens, link tracking, readers, and sent reports, plus the console login URL.

List Non-Temporary SMS Errors

Return undelivered SMS error totals grouped by originator address.

List Pending SMS Recipients By List

Return recipients whose SMS subscription is pending in one MailUp list.

Get Personalization Endpoint

Retrieve one MailUp personalization endpoint including its configured details.

List Published Email Messages

Return one page of email messages currently visible online for a specific MailUp list.

Get Recipient

Return contact details, dynamic fields, and list membership states for one MailUp recipient ID.

Get Recipient Statistics

Return aggregate delivery, view, click, bounce, and unsubscription counts for one MailUp recipient using five rate-limited, read-only statistics calls.

Request SMS Numeric Sender Confirmation Code

Request the authentication code for a MailUp numeric SMS sender and return whether MailUp accepted the request.

Get SMS Message Details

Return the complete XSD-defined content and settings for one MailUp SMS message.

List SMS Messages By List

Return SMS campaign message summaries from one MailUp list.

List SMS Message Send History

Return sending attempts and recipient counts for one SMS message.

Get SMS Message Sending Report

Return aggregate duration, cost, recipient-message, and billable SMS-part totals for one SMS message.

List SMS Message Sending Report Details

Return per-recipient delivery statuses and errors for one SMS message.

Get SMS Numeric Sender Status

Return the verification status code and description for one numeric MailUp SMS sender.

List SMS Recipients By Group

Return recipients in one MailUp group using the SMS channel projection.

Get SMTP+ Priority Codes

List the SMTP+ priority codes available in MailUp.

List Subscribed SMS Recipients By List

Return recipients subscribed to the SMS channel in one MailUp list.

List Enabled Tags

Return one page of enabled tags configured for a specific MailUp list.

List Temporary SMS Errors

Return temporary undelivered SMS error totals grouped by originator address.

Get Tracking Status for Every List

Get one recipient's email tracking status across every MailUp list.

Get Tracking Status for List

Get one recipient's email tracking status for a specific MailUp list.

Get Trusted Sender

Get one trusted sender registration by ID.

List Trusted Senders

Return one page of trusted sender registrations.

List Unscheduled SMS Sendings

Return SMS sending tasks that still need a dispatch schedule.

List Unsubscribed SMS Recipients By List

Return recipients unsubscribed from the SMS channel in one MailUp list.

Import Audience Recipient To Group

Synchronously create or update one email recipient and add them to a MailUp group, returning the recipient ID.

Import Audience Recipient To List

Synchronously create or update one email recipient in a MailUp list and return the recipient ID.

Import Recipients

Queue an asynchronous import that adds or updates a non-empty recipient batch in one MailUp list or group.

List Audience Email Opt-Ins By List

Return one page of subscribed and unsubscribed email recipients for a MailUp list with complete opt-in and opt-out details.

List Audience Email Opt-Ins By Recipient

Return one page of a MailUp recipient's email subscription status and opt-in/opt-out history across lists.

List Audience SMS Opt-Ins By List

Return one page of subscribed and unsubscribed SMS recipients for a MailUp list with complete opt-in and opt-out details.

List Audience SMS Opt-Ins By Recipient

Return one page of a MailUp recipient's SMS subscription status and opt-in/opt-out history across lists.

List Content Sources

Return one page of MailUp content-provider sources.

List Country Codes

Return MailUp's complete unpaged country-code reference for list sender settings.

List Dynamic Fields

Return one page of recipient dynamic-field definitions and IDs.

List Email Messages

Return one page of email campaign messages in a MailUp list, including message IDs used by message editing, sending, and statistics tools.

List Email Send History

Return one page of completed send-history records for a specific MailUp email message.

List Email Sendings

Return one page of MailUp email sending tasks for one queue state: pending scheduling, immediate, or deferred.

List Group Recipients

Return one page of recipients currently associated with a MailUp group.

List Groups

Return one page of recipient groups in a MailUp list, including group IDs used by group-scoped tools.

List Images

Return all full image paths from either the console-wide shared library or one MailUp list.

List Imports

Return one page of MailUp recipient imports with status codes and row counts.

List Import Status Codes

Return MailUp's complete reference table for interpreting import status_code values.

List List Recipients

Return one page of recipients in a MailUp list for one subscription state: subscribed, pending, or unsubscribed.

List Lists

Return one page of mailing lists available to the connected MailUp user, including the list IDs required by list-scoped tools.

List List Scopes

Return MailUp's complete unpaged list-purpose reference table for scope_code settings.

List Message Events

Return one page of recipient-level delivery, view, click, bounce, or unsubscription statistics for a sent MailUp email message.

List Message URL Click Details

Return one page of clicked links for a MailUp message with each link's total and per-recipient click counts.

List Message URL Clicks

Return one page of links with at least one click for a MailUp message, with the click total for each URL or MailUp special-link label.

List Personalization Endpoints

Return one page of MailUp personalization endpoints.

List Personalization Endpoints By List

Retrieve all personalization endpoints associated with one MailUp list.

List Recipient Activity

Return one page of sent-email delivery, view, click, bounce, or unsubscription statistics for one MailUp recipient.

List Recipient Bounce Details

Return one page of messages that bounced for a MailUp recipient, including message subject, notes, and bounce classification when available.

List Recipient Click Details

Return one page of messages in which a MailUp recipient clicked, including each message's total and per-URL click counts.

List Recipient Groups

Return one page of groups to which a recipient belongs within one MailUp list.

List Source Contents

Return one page of content items from one MailUp content-provider source.

List Time Zones

Return MailUp's complete unpaged time-zone reference for list settings.

Register Trusted Sender

Register an email address as a trusted sender and begin MailUp's authorization process; registration does not itself guarantee authorization.

Reset SMTP+ Account

Reset an existing SMTP+ user account and return a replacement password.

Schedule Deferred Email Dispatch

Queue an existing MailUp email campaign for deferred dispatch at the supplied UTC date in exact yyyy-MM-dd HH:mm:ssZ format.

Schedule Deferred SMS Dispatch

Explicitly schedule an existing MailUp SMS sending for a supplied future Date.

Schedule Immediate Email Dispatch

Irreversibly move an existing inactive MailUp email sending task into the immediate sending queue, where delivery can begin.

Schedule Immediate SMS Dispatch

Explicitly queue an existing MailUp SMS sending for immediate dispatch.

Send Email Message to Recipient

Irreversibly enqueue, defer, or snapshot an existing MailUp email message for one recipient email address.

Send Email Message to Group

Irreversibly enqueue, defer, or snapshot an existing MailUp email message for recipients in one group.

Send Email Message to List

Irreversibly enqueue, defer, or snapshot an existing MailUp email message for recipients in one list, optionally including or excluding groups.

Send SMS Message To Recipient

Irreversibly send an existing MailUp SMS message directly to one Prefix/Number.

Send SMS Message To Group

Irreversibly send or schedule an existing SMS message to recipients in one MailUp group.

Send SMS Message To List

Irreversibly send or schedule an existing SMS message to recipients in one MailUp list.

Stop Email Sending Task

Stop an existing MailUp email sending task and prevent its remaining queued email deliveries.

Subscribe Audience Recipient To Group

Add an existing MailUp recipient to one group.

Subscribe Recipient To List

Extend an already-subscribed email recipient's membership to one additional MailUp list.

Subscribe SMS Recipient To Group

Add an existing SMS recipient to one MailUp group.

Subscribe SMS Recipient To List

Subscribe an existing recipient to the SMS channel of one MailUp list.

Unsubscribe Audience Recipient From Group

Remove one recipient from a MailUp group without unsubscribing that recipient from the parent list.

Unsubscribe Audience Recipient From Lists

Unsubscribe one recipient from every explicitly supplied MailUp list ID in one request.

Unsubscribe Recipient From List

Unsubscribe an existing email recipient from one MailUp list and remove the recipient from every group owned by that list, without deleting the global recipient record or changing the SMS channel.

Unsubscribe SMS Recipient From List

Remove one recipient's SMS subscription from one MailUp list without deleting the recipient.

Unsubscribe SMS Recipient From Lists

Remove one recipient's SMS subscriptions from an explicit set of MailUp lists and report per-list results.

Update Audience Group

Update explicitly supplied fields of a MailUp group; omitted body fields are not sent.

Update Audience Recipient Detail

Update explicitly supplied contact and dynamic-field details for a MailUp address-book recipient; omitted fields are not sent.

Update Content Source

Update supplied settings of one MailUp content-provider source.

Update Email Message

Update an existing MailUp email message's subject and content while preserving omitted settings; this changes the draft and does not send it.

Update List

Update only supplied settings on one MailUp list.

Update Online Email Visibility

Publish or hide one MailUp email message on the list's online archive; this does not send the message.

Update Personalization Endpoint

Replace the configuration of one MailUp personalization endpoint.

Update SMS Message

Replace documented fields of one MailUp SMS draft without sending it.

Update Source Contents

Add or update content items in one MailUp content-provider source and return the activity ID.

Update Tag

Replace the name and optionally the enabled state of one tag in a MailUp list.

FAQ

Frequently asked questions

With a standalone MailUp MCP server, the agents and LLMs can only access a fixed set of MailUp tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from MailUp and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right MailUp tools.

Yes, absolutely. You can configure which MailUp scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your MailUp data and credentials are handled as safely as possible.

Start with MailUp.It takes 30 seconds.

Managed auth, hosted MCP servers, and every MailUp tool your agent needs.Free to start.

Start building